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f From the Editor 


elcomc to November MacTech! The leaves are blowing, American Football 
is cranking, your MaePro helps to heat the room, and Autumn is in full 
swing - at least in the North American North! Tve been calling this issue 
our “Windows Issue," but really, it’s about so much more. 

The top story here is about Parallels, from Mary Norbury. While most people 
have heard about Parallels, not everyone has had a chance to use it or see it in action. 
You'll get a first-hand look here, and prepare yourself for when you need to use it. 
Mary has written for MacTech in the past on topics such as XGrid and Unix scripting. 

New MacTech author Criss Myers brings us, “Triple Btwting Your Mac.” 
Building on another one of the Intel advantages that has been brought to the Mac, 
Criss shows you how to stuff Mac OS, Windows and Linux all on the .same machine. 
No virtualization here - they can all run natively! 

Jo.se Cruz is hack with an article that teaches how to integrate the Subversion 
version control system right into XCode. Subversion has slowly been taking over the 
version control space, and will continue to increase its importance in the OS X world, 
As evidence, check out the new Subversion repositories at the MacOSForge site: 
<http://www,macosforge.org>. 

Author Paul Ammann brings us two articles. The first describes a .system for 
graphing spam. Graphing spam} Sometimes, visualization makes a huge difference. 
Let Paul show you how! Secondly, Paul gives us an overview of XSan, Apple’s 
clustered filesystem. This is another technology that not everyone has had a cliance 
to use first-hand, and any familiarity that can be gained beforehand can be useful. 

Christopher Roach, who has written for MacTech in the jrasi, introduces GUI 
apps with Python. Python is an incredibly handy language. Now, you can create Aqua- 
l(K>king apps for end-users, but keep the programming in Python, if that’s your choice. 

All of this is in addition to our regular “AppleScript Essentials" and “Mac In the 
Shell" features. So, no matter the weather, go find your favorite chair, sit and relax 
with this issue of MacTech. Enjoy! 


- Edward Marezak, Executive Editor 
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AppleScbipt Essentials 


by Benjamin S. Waldie 

Introduction 
to Scripting 
InDesign 


In laM month's column, we discussed scri[)Ling page layout 
appiiaitLons in order to automate your desktop puljlisliing 
workflow. Specifically^ we focused on getting started with 
scripting QuarkXPress <http:/AAA/wv.quark.com>. This month, we 
will Ixi discussing another popular and weJTkntJwn page layout 
application, Adol>e InDesign 
<http://www.adobe.coni/ 
products/indesign/>. 


Getting 

Started 


Working with Documents 

Within InDesign, you will most likely want to automate 
tasks that involve documents, so that is what we will foais on 
here. If you need to automate books, you are encouraged to 
explore InDesign's dictionary for the functionality you require. 

Referring to Documents 

A document is feferc'nced using the document class, wliidi 
am be found in tlie Basics Suite, in InDesign's dictionary. 
Documents may be referenced using their index (front to back 
positioning) or by tlteir name. The following exiimple ct)de 
demonstrates how' a document would lie referenc^l using its index. 

tell application “Adobe rnBeffllgn CS2' 
tell docuaient 1 
— Do something 
end tell 
end tell 


Similarly, the following code would reference a document 
by its name. 


tell application “Adobe 
InDesign CS2“ 
tell document “Hy 
document.indd" 

- Do something 
end tell 
end tell 
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doctim«nt n (Inh. (WXyr); AU open documeats 


Before we begin 
senpung InDesign, Td like 
to briefly discuss 
I n Design's Appl eScripl 
support. When you open 
InDesign’s dictionary for 
the first time, one of the 
things you may notice is 
that il is quite long. See 
figure 1. 

InDesign contains 
extensive AppleScript 
support for automating 
almost anytliing that you 
can do manually. Sure, 
you may come across a 
feature here and there that 
doesn'i have 

corresponding AppleScripI 

support. However, these situations are certainly few and far 
between. Furthennore, InDesign's AppleScript support is 
constantly being revised, improved, and expanded with each 
new release of die application, so it [ust keeps on getting 
better. 
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Figure K InDesign's AppleScript Dictionary 


In most cases, unless 
you will always only have 
one document opened in 
InDesign, it is usualiy the 
.safest to refer to a document 
by its name. This way, if 
the front to back positioning 
of a document changes, 
your script will continue to 
raiget the correct document 
Througiiour this 

month's column, however, 
we will be referring to 
documents by their index. 
Specifically, we will 
reference document 1, 
w^hich will refer to the 
froniimjsi documenr, 
Anotlier way to taigei the 
frontmost document is to 
reference the active document property of the appliotion class. 
For examples 

tell applicatioti “Adobe InDesign CS2" 
tell active document 
- Do stunething 
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end tell 
end tell 

Checking for the Existence of a Document 

Before your AppleScript lK^gin,s interadiiig witli a document, it 
is often a gtxxJ idea lo make sure tliat the cicKiiment exists. Tills 
may lie done using the exists command, as follows. 

tell application "Adobe InOeslgn CS2* 
docujDent 1 exists 
end tell 
true 

As the example code above demonstrates, the result of tlie 
exists command is a true or false BtK:jlean value 
indicating whether or not the document exists. 

Creating Documents 

Depending on your workflow, you may not need to work 
within an existing document, but witMn a new document. To 
create a new document via AppleScript, use the make 
command, as demonsi rated lx.'low. 

tall application ’’Adobe InOeslgti CS2“ 
make mv doenmeut 
end tell 

*> document "’Untitled‘1* of application '‘Adobe InUe^sign CS2" 

Tlie result of tlic make command is a mference to the newly 
created document, which nriiiy lie plac:ed in a variable and referenced 
later tn order to perfomi additional tasks wiiiiin Uie doaiment. 

Please note lliat in tlie exiinifile code alxive, we did not spectly 
die size of the doainKfni to lie created In this situation, die 
document would be created using InDesign's defauit dcx:ument size, 
'lb specify a size for die dtx’umeiit, you may o[>iioniiIly specify values 
for the page width and page height properties, whidi are 
aaually properties of the document preferences profx^ny of the 
document class. Here is an example of how this would ix" done; 

tell application ’'Adobe InDesiin CSZ** 

make new document with properties (document 
preferences: i page width:8.i, page heigbt;tilt 
end tell 

-> document "Untitled-1" of application "Adobe TnUesign CS2" 

Again, make note of the example code alxive. Here, 
although we liavc specified a size for the document, we have 
noi specified unit of measurement, i.e. inches, points, 
centimeters, millimeters, eU:. Because of this, the default unit of 
mejtsunemenl will Ix^ used when creating the document, in 
other words, if lnDesign*s default unit of measurement is set to 
inches, then an 8.5" x 11" dcKumeni would \yc created. 

You may optionally chcxxse to specify tJte unit of mesrstrrement 
when oeating the document, as demonstrated below. 

tell application "Adobe InDesign 032" 

make new doctunent with properties (document 
preferences: (page width: "8.5iti" ♦ page height: "llltl" li 
end tell 

document "Untitled-!" of application "Adobe tnUeeign CS2" 

Another way to ensuiu tlial the proper unit of measirrement will 
lx used when the document is created is to modily the defaull unit 
of measurement. *Ihls Is done by selling liie value of the 


horizontal measurenient units and vertical 

measurement units properties t>f Uie dixument's view 
preferences to the desired unit type. For example, ihe following 
.sample code will set the default unit of measurement lo inches, and 
llien cieate the document, ensuring an 8.5" x 11" dcxunienl. 

tell application "Adobe InDeslgc CS2" 
tell view preferences 

set borizontal measurement units to inches 

set vertical measurement units to inches 
end tell 

make new document with propertleE (document 
preferences;(page width;8.5. page height:111] 
end tell 

-> document "Untitled-1" of application "Adobe InDesign CS2" 

Since inDesign’s default unit of measurement may vary from 
user to user, changing the default unit of measutianent to the 
desired value at the Ixginning of an InDesigrirSpecific AppleScript 
is usually gtxxl practice^. In addition to ensuring that a newly 
LTcated ckKument will lx? the correct size, .spciifying the defauit unit 
of measurement at the Ixginning of your scTiiX will help to ensure 
thai resizing or creating other elements, such as text frames, 
rectangles, etc., udl be done using die desired unit of mc-asujement. 

Working with Text 

Developers that are automating InDesign will often have 
the need to interact with lexi frames in InDesign documenu, 
whether that need is to insert text, extract text, formal text, or 
more. We will now discuss a number of ways lo interact with 
text frames in InDesign. 

Creating a Text Frame 

First and foremost is creating new text frames. This will be 
necessary if you intend to add text to a newly created document, 

Ik'fore creating li text fnmie, the tlrsf thing you will want to 
<.kj is tdentily where the texi frame wall lx? created, and how large 
it will be. Once you have deiennmed tills information, you will 
need lo traaslaie it into a list of lx>untLs, which ran lx? s[>ecified 
via AppleScript when the text frame is cTcaied. Ikiuiids of a text 
fnime will be specified as a list of four items, Ibrmatied as follows: 

(top position, left pastlion, bottom position, right 
ponitionl 

Once you have detenninetl the desired Ixiunds for a text 
frame, use the make command to create tlie text frame. In 
doing so, specify the ix>unds for the text frame using the 
geometric bounds property of the text frame, as 
demonstrated below. 

tell applietstion "Adobe InDesign CS2" 
tell page 1 of dotuiuent 1 

Bmke new text frame with properties [geometric 
bounds:M, 1, 3, 61) 
end tell 
end tell 

text field id 191 of page id 159 of spread Id 154 of 
docunent "Untitled-1" of application "Adobe InDesign CS2" 

Assuming that the default unit of measurement is set to 
inches, the code above would create a 5" x 2" text frame 
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that is 1® down and T across on the first of page of the 
front most document. 

Placing Text 

Now that you have a text frame, you are ready to insert text 
into it. To insert text into a text frame, replacing any existing 
content, set the contents property of the text frame's parent 
story to the desired text, 

tell application "Ailobe InBesign CS2" 

tell pateftt story of text frame 1 of page 1 of document 1 
set contents to “Ny Project Text" 
end tell 
end tell 


Ir is also possiiile to insert text into a specific IcKation within 
a text frame, appending it to existing text- Ihis is done by 
selling the contents property of a specified insertion point 
within the parent story of the text frame to a specified value. For 
example, die following code would append the text “My Projeci 
Text'' to the end of any existing text within the specified text 
frame, without replacing die existing text. 

tell application "Adobe InDesign CS2” 

tell parent story of text ftaaie 1 of page 1 of document I 
Get contents of Insertion point *1 to “My Froject Text" 
end tell 
end tell 

Styling Text 
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Text in InDesign passesses numerous properties, inciudJng 
font, point size, color, and mucli more, which are accessible via 
AppleScript. The following example code demonstnUes one 
way dial these propenies could lie modified. This partiailar 
code will set the font tif the text within die specified text frame 
to “AriaT', the point size of the second word to 2^, and the color 
of the first three words to specified values. 

tell application "Adobe InDesign CS2“ 

tell parent story of text frame 1 of page 1 of dociMent 1 
set applied font to "Arial" 
set point size of word 2 to 24 

Est fill color of word 1 to “C“0 H=0 Y=100 

set fill color of word I to "C-lOO M»0 Y^O K^Q“ 

flet fill color of word 3 to "C“0 M-lOO Y-0 K-O" 

end tell 
end tell 


Ple-ase note liiat, in the above example, die colors specified 
correspond to the names of colors in InDesign's Swatches 
palette. See figure 2. 
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Figure 2. In Design's Color Swatches Palette 


Figure 3 shows the result of executing the previous code on 
a text frame that contains the text “My Projea Text^ 



Figure 3. Styled Text in InDesign 
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Working with Graphics 


Labeling Page Items 


interaction with grapliics is often another important aspect 
of scripiing InDesign, In InDesign, graphics are typically placed 
wiiliin reaangles. However, it is also possihlc to place them into 
text frames. For the sake of reducing confusion, in this column, 
we will discuss working with graphic's in rectangles. 

Creating a Graphic Frame 

like text frames, rectangles may l>e created via AppleScript 
by using the make c:ommand, and specifying the desired bounds 
for the rectangle. For example, as.suming the default unit of 
measurement is set to inches, tfie following code would create a 
y X 5" rectangle 1” across and y down, 

tell application "Adobe InDesign CS2" 
tell page 1 of document I 

BUike new rectangle with propertiea fgeometric bounds;(3, 

1 . 6 , 61 ! 

end tell 
end tell 

-> rectangle id 385 of page id 159 of spread id 154 of 
document "Untitled*I*" of application "Adobe TnDesig,n CS2" 


Again, here, the result of the make command is a reference 
to the newly created rectangle. 

Placing a Graphic 

Once a rectangle exists, the place conunand may Ik: used to 
place a graphic within die redangle. The place command 
requires a reference to die graphic file to lx: plated. For example: 

set theImage to choose file with prompt "Please select an 
inisge to place;" without Invisibles 
tell application "Adobe InDesign CS2" 
tell rectangle 1 of page 1 of document 1 
place tbelmage 
end tell 
end tell 

image id 391 of rectangle id 385 of page id 159 of spread 
id 154 of document "Untitled-1" of application "Adobe 
InDesign CS2" 

Here, the result of the place command is a reference to 
the newly placed image, within the rectangle. Figure 4 shows 
an example of a placed gra[ihic within a ret:langle on an 
InDesign documeni page. 



Figure 4. A Placed Graphic 


Tliroughout this column, we have referenced text frames 
and rectangles by index. When we discussed referencing 
documents, I mentioned rha* a more accurate way of referring 
to documents was by name. Tlie same rule applies to text 
frames, reaangles, and other page items within InDesign 
documents. Tlie reason for diis is lhat, if a new page item is 
created, or page items are repositioned within the dcK’unient, the 
index of a page item may change. 

lb always ensure that your script Ls referencing ihe correa 
page item, you may apply a script hM to the item. This may 
be done via AppleScTipt, for example: 

tell application "Adobe InDesign CS2" 

tell text frame 1 of page 1 of document 1 
set label to "myTextFrame" 
end tell 
end tell 

Applying script labels to page Items may also be done 
manually within InDesign by using the Saipt Label palette, 
which can be made visible via the Wimb}W >Automation menu. 
See figure 5. 



Figure 5. fnDesign's Script Label Palette 


Once a script label has Ijcen applied to a page item, you 
may reference if by drat lal>el, rather than by its index. For 
example: 

tell application "Adobe InDesign CS2" 

tell text frame "icyT&xtFratne" of page I of document 1 
- Do fiowetbitig 
end tell 
end tell 

Next Steps and Resources 

Documentation and Support 

If you plan to continue scripting InDesign in order to 
automate processes in your own workflow, there are a number 
of resources available to you for continued learning. 

First and foremost, Adobe provides detailed 
documentation for scripting InDesign. A very comprehensive 
fnDesign Scripting Reference and hiDesign Scripting Guide 


14 


November • 2006 


WViW.MACTECH.COM 














































Don't let your children use 
the Internet on their own! 


You don't let your children read just anything, 
do you? When they surf the Internet they can 
see whatever they want, unless you're there 
to watch over their shoulders. 

ContentBarrier X4 shields your children from 
offensive content, and prevents them from 
stumbling on the dark side of the Internet. 

It protects children from offensive web sites, 
chats, e-mail and more. 



. Intego ContentBarrier X4 

Make the Internet a safe place for your children 

• Protects your children 

• Blocks offensive content 

• Keeps kids safe when chatting 

• Individualized configuration 

• Stores full logs of Internet access 

Mad^ HdW ^ 



* * • « 0 ^ 99 ^ 


Intego • 500 North Capkaf of Texas Hway. Soke 8-I SO • Austin, TX 78740 
Td ^5125 637-0700 • Fax (St 2} 617-0701 * saEes^Sntega.cDm 



















Any Timp, 

Any WhPTP Dafa 


• Mobility: Data delivered any time, anywhere 
in the world* 
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and now SQL data sources, easily and securely, 
no matter where they are* 

• For offline laptops or online home offices and 
multiple office locations - each local copy of 
the database synchronizes its data with the 

others, automatically or on demand* 

• SyncDeK encrypts all data transmissions. 

• SyncDeK works with your databases behind 
your firewall to prevent intrusion, or keeps all 
database copies completely decentralized. 

• Protect mission critical data with SyncDeK's 
continuous offsite differential data backup, 
warm standby and fail-over servers, 

• Sync servers with client-free server replication* 

• Version Update Manager allows you to update 
all copies of the database without requiring 
installation or any action on their part. 

• Call for demo, trial and best pricing options. 

WOrldSync: 

877.548.4920 toll-free 
510.548.4920 international 
www.worldsync.com 


may be downloaded from the Adobe website at 
<http://www*adobe.com/products/indesign/scTipting.htmi>. 
These documents contain extensive documentation with 
regard to all of InDesign's scripting features, and will no 
doubt prove to be an important addition to any InDesign 
scripier's arsenal. 

The online Adobe support forums at 
<http://www,adobe.com/support/forums/> are a iremendous 
resource for anyone using or scripting InOe.sign, or any 
other Adobe application for that matter. Here, you will find 
numerous application-specific forums, including the 
In Design Scripting forum, where you may post your 
questions to other InDesign scripters. 

Expanding InDesign’s AppleScript Support 

Willie InDesign's AppleScript supfx>i1 is quite extensive, there’s 
always room fex iinprovemeni, rigiu? WeD, witli InD^ign's plug-in 
archire<.iurL% it is actually possible to expand its AppleScript support 
with the addition of sciiptable plug-ins. ‘Ibere are numerous 
scripuible plug-ias avaiiable for InDesign, including InCatalog and 
InData, available from Km Stiftware (http://www.emsoflware.coin/) . 
which can l:)e used to automate niiiny complex data-driven 
publishing Casks. For a list of many available InDesign plug-ins. visit 
the InDesign plug-ins page on Adol>e’s website at 
h ttp://WWW, ad o be. coin/products/pl ugias/i ndesi gn/. Also, be sure 
to check t)ui the Adolx: Studio Exchange ai 
http://www.adobcstudioL'Xchange.CQiTt/ * 

In Closing 

For those desktop publishers currenily using InDesign and 
looking to become more efficienl, hopefully, this monthLs 
column lias helfK‘d to shed some light on the fx^ssibilities. Be 
sure to coniinue exploring InDesign’s AppleScript support on 
your (jwn, and don i fotget to check ouL the resources that I have 
mentitmed above. 

Until next time, keep scripting! 

^i\\\ 


About The Author 

Beti WiMe h the m/ther of the best 56% i^5 
^AppleScr’^ting the Rnder" and the "Mac 05 X 
Technology Gakk to Aatamatar"^ avMde from 
hnp://www.spiderwafk5.cotii, as weB as rni 
AppkSaipt Training CD^ amiable from 
htip://www.vtLCoirL Ben is also preshkat of 
" Automated Workflows^ LlC fl congmy spedaSiing 
m AppkScr^t emd workfhw automation considfmg. for yem^ Ben has 
developed professhmdAppfeScr^t-based sc^hns far bosmesses mducBtig 
Adobe, NASA^ K WorUi cmd TVGmde. formoremformathndmt 

Benir fdease visit http://www,automatedworkfhw5,€oai, or eim^ Ben at 
ben@aufomatedworkBows.conL 



WWW.MACTKH.GOM 



















Now scheduling 
and contact 
management 

forpour entire 
organization. 


Now ! Up to Date’ and Contact 5 

Calendar and Contact Software for Business, Groups, Families and You. 



New 

software 


Phooer 866 - 527^0556 
Web: www.nowsottware.com 


Is this project on schedule? When ore you available to meet about the systems 
upgrade? Where are all the field techs todoy? When was the tost time anyone talked 
to our biggest customer? 

Virtually all groups live (or die) by their abilities to meet deadlines and keep track of 
their customers, prospects, and vendors. Few smoll companies or even departments 
of big componies hove the tools they need. 

Now Up^to-Dote & Contact might just be the calender ond contact software for you. 
It's time-tested and used by more Mac^^ased companies than any other solution. And 
it's cross-plotform^available for your PC users, too. It's easy to install ond monage and 
simple for your employees to understand and use. 

Using Now Up-to Date & Contoctyou con schedule meetings for multiple users, view 
muHiple, simultaneous calendors, and reserve rooms and resources. You con shore 
contact information about your customers, prospects ond vendors. And using our free 
server software you can set it up in minutes and shore with users in the office or from 
anywhere with an internet connection. 


Col! us now Qt 86fiKS27-0556 or emoif us ot moctech@nowsoftwore.com 
and well send you our free evoluation kil^ inctuettng fHe book that will 
moke it all aosy^ ^Take Control of Now Up-to-Dote & Contact'' from 
Toke Control books! 


Capyfigtrf O 2006 by Mow Sobwcira. Ir>c. All rlgtrtii Fv^rvftd. How emd No« Con^ qi^ hpdoinorfci of Now Sohwori*, Inc. Moc ond Mac logo wa F/odamofLi of Appla ConiipuMf, lix., 

ragFAiamd in ilia U.S. and pififlT couriNvi., AH Other (Todefn<idr$ dckrtowledged. 













Introduction 

One ihin^i Lliat every crafetnan loves are new ttxals, and 
programmers are no exception to dus rule. If you fall inu> die 
category of a Python developer, then this article was written 
precisely for you. Whai I propose to do during the course of this 
anide is to introdtrce you, the Python progmmmer, in a few 
libraries that will aid you in your developmenl ritual and perfiaps 
even inspire you to develop in new and interesting areas. 

One thing you'll no doubt notice once we start our 
exploration into the tot>ls available far t^ydion developers, is that 
there is no limil to the number of liliraries, packages, modules, 
etc, that you can use to get your job done. What I've tried to do 
liere in this article is concentrate on tlie mast popular and most 
stable, and then perhaps point out a coufde of alternatives for 
those of you not conlenl wilii using just the mainstream tools. 

So, widi our goal clear in our minds, let's press on, and 
begin our journey with a look at .some of die GUI libraries 
available for Python on OS X. 

GUI Libraries 

GUI libraries are an area that in no way, coniradici die 
observation J made in the introducliom Tfiere is a plethora 
of GUI libraries availalile to Python programmers, and many 
of ihese are open source and cross-platform so they can 
easily lie used on the Macintosh OS, as well as many of the 
other operating systems that you may be forced to use 
outside of your own little world. A few of these libraries are 
Tkinler (the standard Python interface to the Tk GUI toolkit), 
wxPython (a Pythtin wrapper for wxWkIgeis, a popular 
cross-platform GUI library written in C++), PyQi (a set of 
Python l)indmgs for the Qt toolkit that is also tTQ.ss- platform), 
and many more. I'll concentrate on two t>f the tnost popular 
libraries in the next two subsections of this article starting 
wiili Tkinter, and then PlI mention a few alternativesS quickly 
in the final section. 


Tkinter 

As I stated in ihe previous paragraph, 'lldnter is the 
.standard interface to the Tk GUI loolkiT for Python 
[Kogrammers. U is also pretty much the de facto standard for 
GUI development wiih Python on any platform. Ihere are 
many advantages to using Tkinter as your GUI library of choice, 
when developing Python-based applications. 

First, it's one of the mtxsi ponable GUI libraries. 7cl and 'lit 
have l>een around for sucli a long time, anil li;we developed 
such a devoted following, that it is nearly impo.ssil^le to name a 
[>ladcjnn that doesn't have a ptm of ihc toolkit available. 
Second, it's really easy to install on the Macintosh operating 
.system; simplyinstall MaePython on your system, railier than 
going with the detault version of Pytlu>n. Finally, it's exU’einely 
easy to develop Glll-based applications with it, Hiis is, of 
course, one of the reasons why Tk has such a large foil tawing 
amongst programmers. Sr), with all of these great l>enefits in 
mind, how do we get Tkinter installed? 

Well, if you installed ilie MaePython binary—rmd 1 recommend 
dial you do <http://hDmepag€S,cvvi.nl/-jack/macpython/cfc™ 
you're already hallway there. Basically, yt>u have 1-^1 lion and tlie 
11<inier interface already, now all you need to do is gf*t a copy t)f 
tlie Tk tcx)lkit. To do this you1I need to download and iastall tile 
latest distribution of the Td/Tk At|ua binary from 
<hnp:/AdTkaqua.SOUrcetorganet> I insLilled tlie Batteries Included 
binary' but you c’an probably get away with just installing 

the 5MB version, liui really, w^hy not install die w'hole tiling and give 
yourself some more toys to play widi later? You am always learn 
Td/Tk after Uiying around with your new Python libraries; after all 
you can never know £ck:> many programming languages. 

Once you've got u version of Tk installed on your 
computer, the only thing left to do is enable the Tkinter 
binary module using the MaePython PackageManager 
application. To do this, find the MaePython folder on your 
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system and double dick on the PackageManaj^cr application. 
Once opened, you should see a package named _tkinter - 
x,x-binary in the package list. Select this package and 
dick on the install button in the form below the package list. 
1'hat's it. You should now Ik" able to create Python programs 
with a Tk-based graphical interface. If you wish to try it out, 
you can just run the simple application below to see a quick 
“hello world” dialog. 

listing 1; TkinterSample-py 
TkinlerSamplepy 

Otatc a ncw Tk aiiplicatian with a root and label object and display it lo die user, 
from Tkinter import * 

# All Tk applications should have a root 
root - TkO 

H Create a nev label, assign it to the root, and give It the 
text "Hello World" 

¥ "LabeKtoot, texr^"Hello worldl". pady=10. padx^lO) 

The conimand packs the root frame tightly around the label 
v.packt} 

if This command starts the main Tk event loop 
root .roalnlooptJ 

To run this program, you’ll need to run the script 
through the Python interpreter l)y typing pythonw 
TkinterSample, py into the Terminal One thing to take 
notice of, is that we use something called pythonw rather 
than calling the normal Python interpreter to run our 
program. The reastm for this is because our application is a 
window-based application (i.e., it does not display Inside of 
the Terminal). The pythonw script executes the Python 
interpreter using a fully qualified path to overcome a hug 
wiiliin OS X. This allows a Python GUI-based application to 
interact properly with the Window Manager. 

If you got everything typed in correctly, and you used 
pythonw instead of python to run your script, you should .see 
a dialog that looks similar to the one in the Ogure fx.*low. 



Figure 1 - TkititerSdmple.py and Emacs 

Well then, youVe tried out the shtJrt application above to 
make sure that your installation of Tkinter works properly, and 
you're still curious to learn more. Well have no fear, wxPyihon 


is another very popular GUI library for Pytlion and we're going 
to cover it in the very next subsection, 

wxPython 

Back in 1992, at the Artificial Intelligence Applications 
Institute, at the University of Edinburgh, Julian Smart was 
designing a tool that needed to nm on kith Windows PCs and 
X-based Unix workstations. The existing cross-platform GUI 
libraries were all tcK> expensive for an in-house experimenial 
projea, and so the decision was made to develop an easy to use, 
cross-platform, GUI library. Thus, wxWidgeLs was bom— 
actually wxWindows at the time, the name was later changed. 

Over time, die libraiy developed a strong following, and in 
1996 , a version for the Python programming language was 
created by Robin Dunn. The port for Pylhon was called 
wxPython. and it was implemented as an extension mt>dule 
wrapping the wxWidgets C++ class library. Since then, die 
WTcPython library has grown to Ixrcome a very stable, powerful, 
and easy to use GUI toolkit, just like Ikinter, it has been ported 
to nearly every computing platform imaginable, which means 
tliat - when iLsing wxPython - you'll \yc able to develop your 
GUT-hased apps with litdc regard for the final target architecture 
or ojxtating system. 

The wxPyihon library^ is an Open Sourc't projea, so the 
source code can he downloaded and manipulated if need be, 
but the most imixirtant thing to remember is that Open Scjurce 
means free, as in beer, just like Tkinter, you can download, use, 
and freely dLstribute applications that you create with this llbmry 
without [laying a fee to anyotie. Uie library Is also extremely 
easy to install, since a binary installer is available for die Mac OS 
X platform which ran be fiiund at Ihe main wxPython website 
<http://www,wxpython,org/>. 

Through my experiments with wnd^hon, i have found that 
1 prefer it to all of the other GUI libraries that I have tried thus 
far I found its installation to Ixf the easiest out of the GLfT 
libraries listed in this article and its populariry^ is second only to 
'Ikinter and rapidly gaining on the Tk UxJkit. Also, just like 
TTiinicr, tltcre are ports of the library to several other ptipular 
languages. So, by learning inter or wxPython, you are 
essentially getting a rtK)! that t:an be used w'ith several d0erent 
languages and not jus! kn J^ython development. 

Other Libraries 

As 1 stated tn die seciion introduction, 1 decided to cover 
the two GUI libraries tliat I found to lie the most popular. The 
reason for this was diat, I had as,sumed (however wrong my 
assumption may M that the most popular libraries would be the 
ciisiest to use, the easiest to find help for, the most stable, and 
the most available to the consumer of our applications. That 
said, there are several other very nice options for Python GUI- 
based development, a few of which we'll quickly look over in 
the remainder of this section. 

For anyone who wanes la develop applications specifically 
for the Mac OS X pladbrm, PyObjC provides a bridge between 
the Pytlion programming language, and the Cocoa Ohjective-C 
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classes. With PyObjC installed, you can create OS X native 
appliaitions using the Interface Builder application to create 
your GUIs, For those of you inleresled in using the PyO[>jC 
Bridge to create your Python applications, we'll be covering it in 
the next section on code editors and IDEs. 

If you're noi really inieresLed in Qxxja development, ytufne 
looking for sometliing a little more cross-platfonn, and you liave 
experience with Java, you may want to look into Jythoii. jython is 
an implemenialion of the Python language whiten in lOO'Mi pure Java, 
so ifs actuaOy inudi more tlian just a conduit to Java's Swing lii^mry, 
but for the purpose of fitting into tills section, we’ll look at as such. 

Ok, I know what you're thinking. Why would I ever need 
a Java impleinentation of Pytlion? Well, just let me point out a 
few of the reasons why you may find Jytlion useful when 
developing Python applications. 

First, having Python implcnienLcd in Java means dial you 
now have the ability to run Python applications on any system 
that can am the JVM. JTiis opens up the oppominiiy of writing 
programs for many more platform.s, .sint:e nearly every platfomi 
now rums java. 

Second—and what 1 really wanted to cover in this .section— 
if you’re like me and you basically cut your teeth on Java, then 
Jython gives you a good starting point to get up and running 
quickly with Python, without the additional overhead of learning 
a GUI library as well. When 1 first staaed learning Python, 1 was 
able to write GUI-based applications in Pyiiion using Swing— 
with w^hich 1 already had quite extensive experience. This 
meant that 1 was able to concentrate more on learning the 
language, and less on learning a GUI library. 


Finally, tliere’s Fv^Qt. TroUtech’s Qt is a very popular GUI 
library for Linux programming, but it also happens to be a very 
able toolkit on several differenl plaifomis (including Window.s 
and Mac OS X, of course). Py Qt is a set of t:jindingxS for TrcjMtc-ch's 
Qt GUI toolkit and like many of our other libnries, tPs available 
on a non-commerc'ial license for free, and am be downloaded at 
<http://wwwjiverbankcomputing.co.uk/pyqt/download.php> My only 
complaint a!x)ut using Qt is that it doesn’t seem to scale that well 
Dirger projects written in PyQt seemed a bit sluggish, even on a 
Ixrefy G4, i.25GHz prtx:essor and 1GB of RAM. Alfiiough, with 
that said, I have noticed tliat larger projects using some of the 
other libraries are not the speediest either. It would seem thjit 
very large-scale, GUl-l)ased projecLs might still he out of reach of 
tile Python develoi>er for tlie time being; much like the Java-based 
apps of a few years ago (recently Java applications have l^ecome 
much more responsive, though still a little too slow for my taste). 

Scientific Libraries 

Since overhauling liicir operating system by adding Unix 
undeipinnings to its already venerable user interface, Apple has 
been gaining ground in the scientific community. Researchers 
in BioinfonTiaiic.s and Computational Biology, Applied Physics, 
and Mathematics—^you name it—have found OS X to be a 
forinldable system for research as well as their day-to-day tasks. 
Tile Mac OS provides a scientist with an all-in-one solution. OS 
X makes it easy for a researcher to run all of the Unix-based 
scientific apps they need, develop programs in a multitude of 
scripting and programming languages, write their research 
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pul:>Iication.‘> using Microsoft Word or LaTeX, and do il all on one 
machine. It is this versatility that has made OS X, the prefeixed 
operating system of many researchers. 

One thing that you’il find common across most scientists is a 
need for powerhil scripting languages. Bioinfonnatics, for 
example, is one area of research where liave seen a strong use 
of popular and p<wcrful scTipiing languages. Perl has historiailly 
been the scripting language de rigueur for many bioinfonnaticions, 
but Python lias l^een steadily gaining ground for several years now. 
Loved by many for its combination of power and readability, {the 
latter of which is someddng that many will say Perl definitely lacks) 
Python has grown on the scientific coniiminiry, and we are starting 
to see several different libntries created specifically for the tasks 
required by diese researchers. 

1 he rest of this section will try to introduce you to a few of 
the more popular libraries for researchers. So, for any of you 
our there considering graduate school a possibility in the near 
fumre, listen up and take notes. 

NuniPy 

Numerical Python, or NiimPy, is a library created principally 
by Jim Hugunin while a student at MIT, and currently imintained 
by a group of developers headed by Paul I^iihois, This libiary 
provides Python with the facilities to handle matrices and Linear 
Algebra mathematics. Ifs a p<.)weiful library that is extremely 
easy to iOxStall, as well as use. 

Installation of the NumPy librarv' is typical of most python 
command line installations, that is, yoiril need to mn a setup script 
through the Python inteipreter with the comjnand line argument 
install. In our case we will need to modify diis a bit by using 


the setup^all.py script instead, and thus, our install line 
should look like tills: python setup_all.py install. 

Running this line from the NumPy directory in the Terminal 
application should install NumPy on your system without any 
problems. Before you get started with die installation, however, 
you may need to download the library. You can do so at Its 
homepage at <http://www.pfdubois.com/numpy/>. 

One more tiling: you may need to be root to install die 
library. So, if you run into any problems during die installation, 
especially ones that mention invalid perniLssions, you may w::int to 
try running die script agiiin, this time with the sudo command. 

Once you get NumPy installed, and you’re able to play around 
with it a bit, you'll notice how gready it simplifies doing complicated 
linear algebra in your Python pR)gram.s. However, even though ids 
great by itself the true power of NumPy C'an te appieciated only 
when coupled with txlier libraries aich as the p<.)pular DISUN 
library—a library for data visuali/alion. With that thought in mind, 
it only seems natural to look into the DISLIN libraiy next. 

DISUN 

DISUN, as was mentioned in previous sulisectioii, is a 
library for producing data visualizations. It’s cross platfonii and 
also quite easy to use. Once again though, we have found a tool 
llial makes use of X windows to produce its visual displays. So, 
remember when running your DISLIN visualizations, you must 
nin them from whatever X windows implementation you have 
decitled to install on your system. 

Even witli the caveat that w'e have to run our visualizations 
under a distribution of X windows, the library is definitely w^orth 
die download, if you plan <in doing unydiing where it will 
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l>ecome important to grapliically vi.sualizc large sets of data. So, 
1 would suggest chat you mn out to its homepage 
<http://www.mps.mpg.de/dislin/> and download the Danvin, ppc 
distribution for die Mae. 

Once you’ve downloaded tlie library and unpacked it into a 
temporary directory, you on proceed with tlie installation of the 
[rackage. Once again, this library will need to lie instailed from the 
command line (no binaiies available, but hey its free, so stop 
complaining), This one is a bit more complex than the one for 
NumPy, hut all of the steps are clearly labeled in die ]^EADME file 
provided with die distribution. Just make sure tliat you don’t stop 
after the installation, but diar you also run through the directions for 
using DISLTN willi Python dial are listed below the iasmll 
instructions. 

Once you’ve got tlie library properly installed, youll definitely 
want to give it a try. So, 
to satisfy your curiasity, 
and also as an example of 
the eiLse at which you can 
create impressive data 
visualizations using 
Python and DISUN, 1 
have inc:luded die cxxle 
for a simple surface map 
visualization l:>elow. 


Listing 3: 
NumPy and 
DISLIN sample 
surface map 
application 
suiface_mappy 

Cremes a surface map 
visuali7.ation using NumPy 
and DISLIN. 

from (lifilin import * 
from Numeric import * 


Jt ^ OirmofriMriMidi ' 


Figure 2 - DISLIN 


2_iiiat “ z^ros( (180. ISO) .Float) 
x_i:ay ^ arangetlSO.O) 
y_ray “ aratige( 180.0) 

dtr “ 1.141592654/180.0 

for X. in x_cayi: 

for y in y_ray: 

z_]nat [ int (x) 1 [ int (y) | 

surshadetz mat ,x_i:ay.y_ray) 
disfin{J 


sin(x*3*dtr)*BlnCy’2-dti:) 


llie results of anining the code above, dirough die Pydion 
interpreter from XI1, can be seen In the figure below. Take 
notice of ho%v very little ccxie you need, to perforin a complex 
visualization like the example that was provided. (See figure 2 j 

Biapython 

With the overwhelming popularity of the Bioinforma tics 
field recently, 1 feel it is imponant to have a portion of our 
discussion look into at iea.st one library for researchers in this 
field. Yet, keep in mind that I am not a researcher in the 


computational biology field (my chOsSen area of study is 
Computer Science), nor do I profess to understand all that 1 
am about to cover below. Regardless of my ineptitude, 
however, I hope that at least a few bioinformaticions out there 
will find this subsection to be helpful and informative. 

$ 0 , with that disclaimer out of the way (and hopefully all 
the hate mail from the bto-crowd avoided), !et*s take a look 
at the Biopythan .set of tools, and w^hat they have to offer the 
scientific community. 

First, Biopython refers to a project that brings togetlier 
many developers of freely available Python tools for 
computational biology. Biopython also refers to tlie tool suite 
that is available online at the Biopython website 
<http://www.bjopython.org>. There are several tools for running 
common operations on setiuences as well as the data structures 

to represent them. 
There are tools for 
running translations and 
BLASTing and for 
performing 
classifications of data 
using k Neare.sL 
Neighbors, Naive Bayes, 
or Support Vector 
Machines. Biopython is 
an extremely large and 
comprehensive set of 
tools for the biological 
researcher. 

For grins and 
giggles, 1 decided to 
download Biopython 
and try it out (1 had 

, , recently begun looking 

surface_inap.pv Sample ^ 

bioinformatics path for my Ph.D., although I may be 
rethinking that again very soon). 1 found that the 
installation was actually not very difficuli as long as you 
don’t mind command line mstallations—sorry, once again no 
binary distributions here—however, it was very time 
consuming. Biopylhon has so many tools that it has quite a 
large set of dependencies, so 1 found myself downloading 
and installing quite a few other packages just to get it to 
work on my machine. 

Nevertheless, after about an hour or so, I finally had it 
installed (with a few optional libraries left out) and 1 was able 
to write up a quick script that took a DNA sequence and 
returned its RNA translation. Not that 1 undersifK)d what I did, 
mind you, but I did feel like a scientist for a very short time, 
and in the process I found that the !iL'>rary should be very 
intuitive for anyone already possessing knowledge of the 
bioinformatics field. 

Also, as a hint for anyone wishing to install this library, 
first download and install Fink (a project dedicated to 
bringing Unix Open Source software to OS X). I was able to 
use it to install most of the dependencies of Biopython, 
making the installation a heck of a lot simpler. 
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A Few Others 

In the final section I wanted to just quickly ineniion a few 
other libraries that [ found for Python, which were no less 
imt30rtant tlian tliosc in die sections prior, but since fm not 
writing a book, [ had to draw the line somewhere. So, this 
section just quickly introduces a few more libraries that I think 
are must haves For any serious Python programmer. 

Well start with a couple of libraries diat allow Python 
scripts to access and utilize arguably the two most jx>pular oi>en 
source ckiLabases; MySQL and PostgreSQL. Ilien, we 11 quickly 
look into two more libraries diat allow tfie Pythtin programmer 
to create 30 grapliics on OS X. 

Databases 

In order to standardize the many modules that allow Pydion 
developers to access a database, a database API specification, 
which is curRmily in version 2.0, was developed. This makes 
Python programs that access a database, not only easier to write, 
but also infinitely more ponable, since all that needs to change 
for the code to work widi another database is the module that 
implements the specification. 

In this section I wanted to quickly point out two 
maduies that allowed Python programmers to access two of 
the most popular Open Source databases. Tfiese iTH)dules 
are: MySQLdh and PyGreSQL, both, of course, are compliant 
wiiii version 2.0 of the Python Database specification. 

nie first, MySQLdh, Ls, of couisc, an interface to Lite MySQL 
database. 'Ihis module is fully tliiead safe and supports tniiisaeiioas. 
Ks easy to install and e^tsy rn iLse, and ir can be used with any version 
of l^tlion above vl.32, and wiil i versions of MySQL v3.22 or greater 


The other module I wanted to jxjittl out works with the PrxstgreSQL 
dnaba.se. PyGreSQL is the name i>f the module that provides Pytlion 
witli the ability to acc'ess and utilize a PostgteSQL database. 

If neither datalxise is currenUy iasuillcd on your machine, and 
yoiire not particularly interested bi going througli a long install 
%vith the sourer, Marc Liyanage has links and insmjctions on his 
website <http://vvvvw.entrapy.ch/softw^ for downloading and 

installing eadi database on OS X with a binary installer. 

If, however, you prefer installing from a source distribution, 
you C 2 in find .some dotrumentation on installing each one in the 
Open Source section of Apple's Developer Connection 
<http://developer.applexom/ internet/opensoufc€/fndex.html>. 

Once you’ve installed tlie ditabases, you 11 be ready to mstall 
MySQLdb and PyGreSQL nKxJules. You can find the MySQIdh 
module througli the Sourceforge sice at tlie following address: 
<http://sourceforge.nGiypfojed^mvsql-pytho^ Tlie PostgreSQL ditibase 
module, PyGreSQL, can lx: found at its liomepage: 
<http7/www.pygresql.or9/> 

Graphics 

lime are several chokes for graphic's libraries when working 
w'iih Python on the Mac As I already mentioned earfier. Python 
dcvelojxrrs t>n tfie Mac have access to the DISIJN visualization 
library'. However, these obviously are not die only ouoi, in this 
.section HI quic:kly intrcxiuce two other 3D graphics liliraries. 

To start with, VPython is a data vi.sualizaiion library similar 
to the DISLIN library, However, its main aim is ease of use, and 
at least from my readings, it seems as if it is lieing geared towards 
studems in tlie sciences. As for the installation of the library, my 
recommendation would be to install it from Fink (use the 
command Link install visual-py23), and that seems to 
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Web Mining Case Study #104: 
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be the general consensus since e\^en the homepage of VPython 
<]ittp://www.vpython.org> recommends the same. 

The other library gives us access to what Is probably the 
most popular aoss platform graphics library: OpenGL. 
FyOpenGL binds Python to the OpenGL 3D graphics library^ 
version l.L The library is a bit behind, since at last check, 
OpenGL was up to version 2.0, Nevertheless, It works well, it's 
cross platform, and it’s extremely easy to use. 

Once again, this library does not have a binary instailer, so 
you'll liave to download the source <http://pyopeng!.sourceforge,net/> 
and build it. Nevertheless, when T built the library on my macliine, 
the build and install steps went by without any incident 
whatsoever, and laefore 1 knew it, 1 had a sample Python-based 
OpenGL program up and ranning. 

Conclusion 

Well, weVe certainly covered a lot of ground over the course 
of diis article. I hope youVe found soine interesting new tools to 
play witli in your future Pytlion development, I also hope that IVe 
inspired you to go out and start doing some msearch on the web 
to find even more new tools for your Mac. And who knows, 
perhaps you’ll find a void somewhere our there in the ukjIs 
available, and youll Ixf able to orgiinize an effort that delivers 
another powerful library back lo the Pytlion conmiunity. 

Tliis ailicle's main objective was to whet your appetite, and 
liopefiilly get a few of you to try soineiiiing new in your daily 
deve[t)pmeni rituaL In die lliture, III te ptiblisliing a few articles that 
take a Icxik at some of tlie ta.iinologies we covered here, a little 
ck>sei. -So, if you enjoyetl this anic'le, and you find yourse^lf t]iiist>' to 
learn some mom, liave ntj fear, Td liave a few nioie in depth mtorials 
out diere for you to sink your teeth into, sometime very soon, 
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Mac In The Shell 


me=${dEcl /LDAPv3/127,0.0.1 read user 

KallAttributej 

if ( != “No key: MailAttribute" ]; then 

echo '*$ufler" 
fi 

done 


by Edward Marczak 

Directory 
Service Recipes 

More Directory Services ' 

manipulation via the 
Command Line 

\ __ J 

Introduction 

Directory Services: used every day by users of OS X - 
whether they know it or nol. Last montlh Uiis column covered 
the basics of directory services, and gave a few sample ideas. 
This month, 111 trot out some very praciini! uses of itie 
comniand-iine directory service tools. 

Power Station 

As IVe alluded to in the past, ct^mniand-lmc tcxjls and saipting 
- sliell Irasc^ or GUI Ixised AppleScript - an lie much more 
(xiwerfijl tlian GUI tools. Also, while I pointed out that LDAl^ is 
not a database, people still lend to iliink of it as one. Tlie confijsion 
is understandable: Directory Servte protocols allow you to retrieve 
infoniiation via lookups. Depending on \hv prtatx.'ol and your 
access, it may allow yoit to lx* tlie one to store infoniiation, too. 
IJke any diitalxise, tlie retrieval of inforniatjon is key: it would be 
useless if you could put information into the store witliout Ixing 
able to access it. Combined with .scripting, not only can we access 
data, but wc can perfonn actions using the results. 

Let's start out with reading and reporting on values. OS X 
Server using Open Diretiory stores just alxjut cverytliing for a 
given user in a rectird in LDAP. Sometimes, you1I want to know 
which users have some attribute. I do a lot of work with OS X 
e-mail systems, and a common request is an easy way lo report 
on which users have mail enabled Cor, conversely, which users 
are nol mail enabled). Here's a handy little script that will do 
just tliat “ show wiiich users are set up for OS X e-mail: 

niaU-cnabled.sh 

#!/hln/sh 

for user in ^tdscl /LDAPv3/127.0.0.1 -list /Ugers) 
do 


Do mxice liere that we’re relying on thefaiiurv to find llie attribute 
as a way to make our determination. If you want to find users who 
do not have mail enabled, just change the test from not equal CH”) 
to equal (“=="). If you're a Kerio Mail Server user, and arc using 
die Open Directoiy^ extensions, raiher tJian “MaiLAttribute”, you 
want to Icxik for *^ke^it^MaibActive: T. Run this right on your OD 
master or replica to get your results. Ibis can be exlentled io run 
from aofi every night and pnxluce a rept^rt via e-mail. You could 
even redirect the results lo a file and use diff to report on new mail 
users, and users tltat liave lieen disabled. 

Everything but the Girl 

Let's even go easier, but potentially more useful. 
Hierarchies on a network arc aseful. People tend to tliink in that 
manner, and like lo piess them into service, you're using OD 
based logins, with or witboiU network home directories, you 
have a handy tool at your dispcxsal: your u.ser list. More than 
once, Tve been asked to create a sliarepoint on the network, and 
then fill it with a directcjiy' for each user in the system. On a 
large system, this could Ixf incredibly tedious. So, you scTipl it. 
Or, in this t'tise, you can even one-line it: 

dficl /LDAPv 3/127.0.0,1/ list /Users | xargs mkdir 

Of course, that will create directories at your current place in the 
smictiire. This means that you'll want to cd to the location you 
want them liefore amning this command. 

While handy, you probably need a little l)it more, like 
.setting the correct penTiis,sions, or even copying some default 
information into each folder. An easy framework for that is: 

i? I /birv/bash 

decl /LDAPvB/127,0,0.1/ -list /Users | while read user 
do 

#Do your work here 
done 

Quick results from little work! 

(Don’t Burn the) Midnight Oil 

Anotlier really handy sceaario crops up with OS X 10.4 in an 
all OD network. Using a icxrl like Apple RetiKae Desktop, you can 
certainly create l(x:al admin tesers on all macliines in your netwwk 
very etesUy. However, tliat can iTecome a small management 
hcadaciie: If ycxi want to change the password lor die admin user, 
then you have to lememlxT to get every boK. It also doesn't allow 
for any fine-grained contiol. One great solution to this ts to create 
admin groups in OpenDirecton^ You can then nesi liiese groups 
inside of the Icxal Netlnlb admin gn>up. From tliere, simply moving 
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users in and out of the C^D admin groups will give them the correct 
pemiLssioas on a given machine. Lefs look at an example. 

Imagine that a company (or school) has two open labs: one 
for word prtxessing/presentation development, and another for 
3-D graphics. Rach lab has a local sup[X>rt team tliat need admin 
rights to the Macs, You would create three groups in 
Open Directory: WPLabAdmins, 3DLabAdmins, and UberAdmins 
~ the final group being able to administer Ixrth labs. Assign 
users to the appropriate groups. You 11 then need the OD 
group's UUID, wliich of course can be scripted. Create the script 
as Li pda te^a dmin-gro u p .sh: 

update-admin-group.sh 

#!/biix/baah 

tfaeUUIl>~$Cdscl /Search read /Gxoups/$l apple-genarateduid \ 
sed "s/apple-generateduidr //g'] 

dscl /NatTnfo/roat -create /Croups/admin NestedHrDaps 
$theUUTn 

Then, run it on eac:h grou]> of machines as appropriate: 

On all machines: 

update admin'greup. sh UberAdniliis 

On the word processing machines: 
update admin-group,$h WFLabAdmins 


Value[l] is <80) 

Attribute[5] Is <dsAttrTypeStandard:Password) 

Value[Ij is <*> 

Attribute[6] is <dsAttrTypeStAndard:GroupHenilSership) 

Value [1] ifl <root) 

Value[2] Is <localadmin) 

Attribute[7] is <dsAttrTypeStaiidard:GeneratedtlID> 

Value[1] is <ABCEEFAfl CDEF-ABCD-ECAB’CDEFOOOOOOSO) 
Attribute[8] is <dsActrTypeEtandard:SMBSID> 

Valuell] is <5-1-5-32-544) 

Attribute[9] is <dsAttrTypeStandard:RealKame) 

Value[Ij is <Ad^nistraters) 

Attribute[10] is <dsAttrTypeStandard:GroupHembers> 

Valuell] is < 43 CV 3 B 6 A CFB 9 -4C24- A 464 -EA 5 n 20 B 62 D 2 > 
Value [2] la <F047F2F1 F 5 A 9 - 4 B 73 -BBB 4 - 454550 B 09 CB 4 > 


1'he same tiling can lx? acctimplished for an OD group, 
using the n switch: 

# deed!tgroup -n /LDAFvl/127.0*0.1 admin 

dsed It group abo has operations to rmnipulate groups, either 
local (NelJnfo), or other datastore. lb remove a user from an 
OD admin group, you could handle it this way: 

dsaditgroup -o edit -n /t^DAPv3/l27*0.0*l -u admin-user *p -d 
user-tC'delete -t user admin 


Note that sensitive operations against Directory Services will 
ixx|uire authentication, as seen here with the -u and -p flag* 


Conclusion 


Finally, on the 3D machines: 
vipdate ■ admin - group, sh IDLabAdmlnK 


N(>w, as people need admin access to a given machine, they can 
simply use their own OD ID. Very, very cool. Once this is set, 
you can just move pet^ple in and out of OD groups, father dian 
liitz with anything on any local machine. Much better, right? 

Ah Ha! 

dscl: incredibly useful However, Td lx: remiss if I didn’t 
mention its counterpart that appeared in 10,4: ds edit group, 
d sed it group appeared to make it easier to work with groups, 
especially with the new ability to have nested groups. 

By default, dseditgroup operates on Netinfo data, but, as 
the *ds' suggests, will work with any Directory Service plug-in. 
This includes anything you can set up in Directory Utility, such 
as LDAP and Active Directory, So, while we're speaking alxiut 
admin accounts, let's see examples of dseditgroup in action. 

To read all information alxiui a Netinfo group, simply use 
dseditgroup groupname. So. to see your admin group: 

# dfseditgroup admin 

Recurdname <admin) 

10 attributeCs] found 

Attcibute[1] is <{!sAttrTypeStandard:AppleMetaNodeLocation> 
Valuefl] is (/NetlTifo/DufaultLocalNode) 

Attribute [21 is <dsALttTypeStandard :RecordTyps> 

Value[tj Is <dsRecTypeStandard:Groups) 

Attributed] Is <dsAttrTypeStandard:RecordNaije> 

Valuell] is (admin) 

Attribute[4] is <dsAttrTypeStandard:PriinaryGrouplD) 


Directory services in genemi are an incredibly powerful 
way to maintain a central store for objeas on a network, easing 
administration. The usefulness of these services wcmldnl be 
diminished if only GUI Kx>ls were available. I do hope, though, 
dial IVe tllustnited how ptjwerful scripting and command-line 
tools can be, and what liiey bring lo die process. 

Media of the month: Mtcliael Bartosh's postliumously released 
Mac OSX TigerAdminMralum. A surpri.se follow-up to his PUniber 
Seruer Administration after lieing told tliat tfie Tiger version was 
cancellcxl. TiiLs PDF-only version of the book was started [)y 
Michael, and cximpleted by several of hts good friends after Michael 
pissed away. Ifs available from <http:/Awww.orielly.coni>. 

Again, it's time to make your plans for MacWorld! Hope to 
see people on die show fltxir, or at either of the sessions Pll be 
presenting (old news to long-time readers of my column, 
though!). In any case, ril see you in prim next montli. 

References; 

dscl man page 
dseditgroup man page 
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Virtual Computing With Parallels Desktop 


How to leverage Parallels Desktop for Mac to run Windows and Linux VMs 


By Mary Norbury 


Buzzword 

Wily is virtualization becoming the new indusliy liuzzword? 
It's certainly not new, [liM has iK'on developing vimial machine 
systems since the inid4960*s when they virtualized server 
ntemory. In the mid-1980s^ we saw CPU and I/O virtualization 
and the 1990s htought die lechnology to open (Unix liased) 
systems. Cluster and grid computing have long provided resource 
virtualization solutions. Linux distributions such as Novell Redhat 
and Sun are embedding the Xen VM (virtual machine) monitor 
into their enterprise serv'er editions. With MicTosolt also entering 
the virtualization arena with its acquisition of Stjfiriciiy and 
partnership with Xen through Xensource, the market is heating up 
with new possibilities and choices. 

Rnler Apjile witli their new Intel line of mobile, desktop and 
server computers and virtiialtzaiiion comes to Lite Mac. 

Apples and Oranges 

It was no surpri.se that Apple introduced Boot Camp- clearly 
someone was going to accomplish Ixioting Windows natively on 
an Intel Mac so it made sense that Apple CTeaied ilieir own neat 
solution. ITiis had such a major impact on how Mac users view 
Windows interoix^rability that Microsoft will no longer tifTer 
upgrades or full releases of Virtual PC for Mac. Fatiulation is out 
because we don’t need it anymore. 

Installing B<x)i Camp is a hit more difficult than Panillels and 
there are some pitfalls: you can t install it on your Mac if you’ve 
alieady got a partition st) ytHt’ll need to lestoa" it to a single volume; 
you're limiiecJ lo cieating a static partitioti le^ss than 32 GB and 
Ion flatting it as FAT32 rather than HiVS if you want ttj write to die 
partition after installing Windows (if it's larger ilian 32 GB then 
you 11 have tti format it as NTFS and it will then become read-only 
for Mac OlS X); die partition you create is static in size; you can only 
install Windows XP Pro or Home and you c^in't muUi-lxxK different 
versions of Window.s since Ikxit Camp only sup]X)its duabbcxit iHd. 
Note “ but you can {>vcrcome this: see Criss Meyers' article^ Triple 
Btxx Your Mac" in this month's issue!]. The newest !x:ta of Boot 
(Jamp V, 1,1.1 fixes .some bugs, adds supptirt for the Mac Pro line 
and includes a preset button for the 32 GB size option. You can 
upgrade your existing Boot Camp instaU as long as you don't intend 
to change die partition size (hltp://wwwjppfe,corTi/macosx/bootQrfip/). 


This begs the tjuestion about installing Linux on Intel Macs 
using Boot Cam[i, This is possible^ hut creating a lKX)table Linux 
partition is a bit trickier because you want to make sure you 
don't change die partition table during install; Bckx Camp 
creates a hybrid ]>aitition table where XP's legacy MBR (Master 
Boot Record) and the Mac OS X GPT (GUID Partition Table) can 
co-exist and play nice. Since Boot Cimp was only intended for 
an XP dual boot setup, adding Linux can lie a challenge- But lo 
nitpick, Mac users have lieen able lo dual hoot Yellow Dog 
Linux on PowerPC’s since 1999 so die Intel Mac and Boot Camp 
compliciUe the Linux experience rather than enhance it. 

On the other hand, Boot Camp is undcnial>ly faster than 
Parallels liecaiise it runs natively and gives Windows full access 
lo the CPU, gniphics and odter hardware. Parallels is a virtual 
machine environment and therefore only sees a dual core 
system as a single core with an 8 MB graphics caicl no matter 
how good of a video card you have installed. 

Why Be Limited To Windows? 

A ccjlleague and MacTech audior Dean Sliavii, who writes 
The Source Hound" column, states in his liio tliat he hates to 
pay for software, Hmitimm...well. we're ail for “free," and feel 
especially Idesscxl when, on rare occasions, “free” equals 
''awesome*'. Boot Cainp is free and fast and pretty damn 
good.*,.but Pnnillels Deskttjp accomplishes more ihan allowing 
a duaMKJOL with Window^s XP or a difficult triple 1k)oL system 
with Windows XP and Linux. With Parallels, you can run 
multifile virtual machines simultaneously and you don't have 
to bcKX the H<isL (Mac 08 X) 08. You aren’t limited by yoor 
personal choice of operating system. You can move seamlessly 
between Host and Guests. Is this wiirth [laying for? Hell yes. 

Nitty Gritty 

Parallels Desktop for Mac is available from 
http://www.parallels.com with a trial key or purchase for $79.99. 

Download the package and follow the instructions for 
installation. Lmnch Parallels.app and select the New- VM... 
button to create a new virtual maclune, You1l be asked whic:h 
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Figure 1. Create a new VM and choose configuration type 

Pirallefi Desktop Fife 


Pletii iptclfy which puut operating syitem will be 
idMailed on thit vinuaf mKhinL 



y^|| Select guest OS 


fagh ) ( CffBEil 


VM Oevlcea Help 
I4ew Virtual »«dwn« Wtivd 


Please specify which guest operajhng lyitem will be 


t 


Windows J.U 
Windows 
Windows 99 

Ml mwchin*. 

Windows ME ; 

Windows NT ^ 

Windows 2GO0 
windows 

m 

f- 

U Windows 2003 1 


Oth«r Wlndowi 



> 


gSfc?: V 


; trH^^ C^D 


Figure 2. Choose the Guest OS type and Guest OS version 



synchronize 


time... save money 


Download a demo, and get more information at 

www.fmSQL-Synch.com 


Garrison Computtr Services 
info@gafrison.com.au Ph:2 4575-5247 
www.garrison.com.au PO Box 141 Windsor N SW 2756 Australia 


fmSQL Synch eliminates double 
data-entry... forever. 

You can now synchronizo your FileMaker and web 
(SQL) databases. Data is compared on a recofd- 
hy-record as well as field-by-fletd basis. Existing 
databases can be configured for synchronizing 
with just a few modifications. 

Some of the features Include: 

✓ Eliminates double data-entry 

✓ Two-way synchronizing 

✓ Field level conflict checking and resolution 
t/ Setup Assistant 

✓ Creates all SQL statements for you automatically 

✓ Easily integrates with existing FileMaker 
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Salvation Awaits You. 


Convert Now. 

Change the way you live, work and play. Convert to Razer 
ProjSolutions^ for faster speed, more accurate control, better 
response and superb precision. In essence, increase your 
productivity. It is the Way to perfection. Born from a marriage of 
form and function, the ProjClick™ v1.6 is a godsend. 

Surrender to Salvation. Click & Convert Now. 



Works with both 

PC and Mac 


Find out why you should convert @ 

WWW.razerpro.com/converl 


Available at; 
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type of \'M ctynfigunition you want to create {typkial, t:u.sU)in or 
blank). The Contlgiiration Rdiuyr can be used bier to 
reconfigure settings. 

Ch<Kxse the Guest OS type and the version: (See Figure 1. 
and Figure 2., page 33.) 

Name your virtual macliine and choose a location to save 
the configuration file (let Parallels Desktop create the .pvs VM 
config file for you automatically). Two files make up a VMi the 
.pvs configuration file and a hard disk image file* Parallels 
Desktop c:ao run one VM (or one coofig file) at a time, biuacli 
Parallels Desktop for each individual Guest OS, 
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Figure 3. Virtual machine name and 
configuration file location 


In the Property Page, youT activate Parallels Desktop 
(Help - Activate Product...) with your trial key or your full 
registration activation key* Then, still in the Property Page, 
you 11 make some changes to enable Ixjoting from your guest 
OS install CD* Under Configuration, locate the Guest OS line 
under File IxK:atk)n and click cm the Boot Sequence link to 
open I lie BcKUing Option s tub. 
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Figure 4. Property page 
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'AQUAZONEi 


^AAllume 

wXSystems 

A Division of Smith Micro Software 


Jyindwaifkil 


FORTY BEAUTIFUL FISHES, 
TURTLES, JELLIES, & SHARKS! 
INTERACTIVE SCREENSAVER 
TAP THE GLASS, FEED THE FISH 


jsmanyonscrepn 


\ virtual aquarium so vibrant, you'll swear the fish are real! Available from your favorite retailers and catalogs. 

Aqua 2 on€ Seven Seas Deluxe indudes 40 fresh and saltwater fishjelfyfish, adult and baby sea turtles, and sharks! Have entire schools offish on screen swimming through 20 customizable 3D tanks! 

TM, and 02005 Allume System^ live. To lejm ntote isbouidur range of software solutions for your lAatintosb, please vltit us at www.alfume.coni. 
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Figure 6. Adjust memory allocation and check hard disk options 
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Highit^rht tht; CD/DVD drive in the Resource pane and 
make sure tlie device is enabled and will arnnect ai siartup. If 
you are installmg from an .iso iiiuigc, an inig or an .fdd (floppy 
disk image), select the Use image file radio button and speciiy 
the patli to die distribution file in the image file field that appears 
when the image file radio Imiton is selected, 

(See figure 5.) 

Select die Menioiy ocJtion in the Resource pane and adjust 
the memory alloc^ition. Windows XP or Server 2003 will run l>est 
with a minimum of 512 Mli. Give it as much as you can afford. 
If you have 2Gli RAM on your OS X system, give the VM 1GB. 
Linux flavors will demand less (256 MB minimum). 

Highlight the Hard Disk Resource in the left pane and 
choose the Advanced tali. You'll see that my choice of a 
Typical creation of a virtual machine set the virtual disk size 
as BOOO MB with an expanding formal. Note that the actual 
size of the disk image file {after full installation) is 1330 MB 
hut will grow as new data is added so you don't have to 
w'orry about allocating enough hard drive .space to the virtual 
disk before installing. 


(See flgum 6.) 

Ciick the OK builon to return to the Property Page. Click 
the Save Imtton along the bottom of the window to save the 
VM configuration. Insert your guest install CD and click the 
green Powder On arrow ho non to boot the VM and begin 
install. Parallels Desktop wall detect the CD and start 
installaiion. 

(See figure 7,) 

During any Windows OS installation, you1l be 
confronted with the Microsoft Licensing Agreement screen, 
which requires an L'8 key input to agree lo the terms in order 
!0 proceed with the insialiaiion. On laptops, this is 
accomplished by enabling the ""Use the FI-FI2 keys to 
control software features'* in the Mac 05 X keyboard pref 
pane. Once enabled, you ('an use the fn-F8 key combination 
to agree to the MS Licensing Agreement and complete the 
insialiation. On desktop models that come willi the Apple 
Keyboard, simply turn off (deselect) tlie F8 keys shortcut in 
the Keyboard Shortcuts pref pane and the F8 key will be 
fund tonal in the Guest OS window. 
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Your G5's Dream Date 




The 3ware Sidecar & Your Apple Power Mac G5: The Perfect Match 


The Bware* Sidecar by AMCC is a powerful SATA RAID desktop storage solution designed specifically for the Apple* Power Mac* G5. 
At speeds 4-8x faster* than Firewire or USB, It can store and proiea tons of your photos, songs, videos, fllusirations and web pages. 


Whether you're editing and archiving digital photo shoots or snapshots, home movies or future 
Academy Award* winning films, garage jam sessions or professional mixes — rest assured your 
data will always be proterted The 3ware Sidecar Is designed for aeative professionals and 
enthusiasts who care about their data and just can't risk losing It! With the 3ware Sidecar, 
your data Is RAID protected, so a failed drive won't mean the loss of hours of creative output 

On the set, in your studio or at the office, the 3ware Sidecar lets you think outside the box. 

And with up to 5TB** of storage capacity, there's no need to worry about running out of space. 
Just install, set up and connect — iTs as easy to use as I -2-5. 

3ware Sidecar, the perfect partner for your G5 workstation — no dinner required. 


>1MCC 


Think Outside the Box 

Find out more at WWW.3ware.COin 

Or call (877) 88-3ware; 877-883-9273 


' SATA II: 300 MB/second; Firewire: B0MB/sor40MB/s; USB 2.0; 4SMB/S 
** Usif>g four 750 MB SATA drives (riot Included) 
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Figure 7. Windows Server 200S installation 



Figure 8. Windows Server 2003 booting up 


tunnel between a low risk world and a high risk one. Viruses 
may noL exisl for Mac OS X right now but in the future, the 
operating system may become a bigger target l^y virtue of tliis 
new ability to become bedfellows with operating systems 
fraught with vulnerabilities. If you choose to nm an alternative 
OS on your Mac and [)hin to share files, then praclice safe 
computing: keep all operating systems and applications up to 
date, run appropriate anti-virus software (take a look at 
ClamXAV for Mac at http://vvww.markallan.co,uk/damXav/. open 
source and free!), and close all but necessary ports. 

After taking care of this business, you can install Parallels 
Tools (available from the VM inenu) wliich prt.)vkles: better 
mouse synchronizaLitm (you can move seamlessly Ixrtwcen tlie 
Guest OS console and the Finder without using hot key 
combinations to capture or release input), enhanced video 
performance, time and ciipfioard synciironization, a disk 
compacting tool and a shared folders tool You II need to l:ie 
logged in to the Guest OS to install Parallel Tools, 


Once installation is finished and you’ve created your 
account infonnation, you can log into your new Gnesi OS by 
sending key combinations through the VM menu (Send Keys - 
Ctrl+Alt^^Del), Start and stop the Guest OS by using the Power 
On {green arrow) and Power Off (red sciuare) buttons on the 
toolbar on the riglit edge of tlie Parallels Desktop windtjw (you 
can move the toolbar to the top or the left; go to Preferences - 
User Interface). 

Tile next practical step is to run the many Windows OS 
patches from Internet Explorer (Tools - Windows Update fram 
the IE menu bar), turn on automatic updates (Start button - 
Settings - Control Panel - Auiomatic Updates), turn on the 
firewall (Start button * Settings * Network Coniiections - Local 
Area Connection - Properties button - Advanced tab - Windows 
Firewall Settings liutton) and install an anti-virus software 
package. But don’t worry: even if your PC virtual madiine gets 
a virus, it won’t spread to your Mac host. If you take advantage 
of a shared folder, however, be aware that you are opening a 
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Figure 9. Install Parallels Tools 
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After completing the installation of Parallel Tools, shut down 
the Guest OS tdo a graceful shutdown from inside die Gtscst OS 
or you may generate shut down errors when using the Power Off 
button in Panillels Desktop), You 11 be reairned to the Property 
Page, Click the Edit button on the bottom of the Property Page to 
return to die Configuration Editor Highlight Shared Folders in the 
Resource pane on the left, select the checkbox for Enable shared 
folders and click the + button to open the Shared Folder 
Properties screen. Specify a Name and Path on your Mac OS X 
system for the sliared folder (a sliared folder on ihe M;ie OS X 
desktop is convenient and sensible; create one if you havent 
already done so) and ,selett the Enabled option at the Ixittom left 
of die pane. Click the OK button. 
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Figure TO. Create a shared folder 



You're now at the Property Page again: dick liie Save 
button along the bottom of tlie window. 

Power on your VM and log into your Guest OS, You should 
now see a Parallels Shared Folder on the desktop. Doulile- 
clicking it will open Windows Explorer You can browse and 
WTite to the contents of the share from there. 

If you have View Hidden Files and Folders set in the View 
lab of the Folder Options in Windows, you will see OS X's ,ds 
store files. 
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Figure 11. Shared folder 


Or, you can wxitc directly to the Window^s disk. Each VM is 
assigned an independen! fP address. Go to the Windows run 
line (Start - Rim) and type cmd. At the pixunpt, type ipconfig 
and make note of the IP address. Enable a shared folder (My 
Documents on the Windows de.sktop, for example) and give 
yourself j^ermissions to write to it. In the Mac OS X Finder, 
select 'Go’ from the menu and t:htK)se 'Connect lo Server', Type 
in the VM IP address using the siiib protocol (ex. 
smb;//10-0,T8). Click the GonnecT button. Enter your Windows 
login and password with permissions to the share you cTcated. 
Select the share in the next window and click ‘Oli\ The share 
w'ill mount on your OS X desktop. 

Another very cool feature is the ability^ to copy/paste 
between Mac OS X and Windows. No ret)ooting, no special 
keystrokes required. 

You can also view devices connected to your system. Select 
VM in the menu bar and choose Devices. 
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Lasso Professional empowers the productivity'focused developer. 
The language is clean, clear and consistent making new code easy 
to write and on-going maintenance more productive. High-level 
language features significantly reduce the amount of code required 
to accomplish tasks compared to other languages, and integrated 
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application, and enables "build once, deploy anywhere" solutions 
through support of major operating system platforms. 
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Figure 12. List of devices seen by VM 


• Increase llic dcfauk memory allocafion to 512 MB, 

• Selea tlie CD/DVD Rejsource option in tfie left pane of the 

Configuration Editor and choose tile Use image flic radio 
iiuLLon. Select the path to the .iso image fife. 
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Earallels Compressor is a tool that allows you to manage die 
size of your virtual hard drives. Select it from the VM menu and 
click the Manual button to control how the drive is optimized: 
Express or Advanced, llie Advanced Option allows for fine- 
tuning level of compres.sion. 


Figure 14. FressBSD image file 

If you have not installed FreeBSD before, pulileeze read the 
handbook before and during installation: 
<http://www.freebsd.org/doc/en_US.lS088 59- 
1/books/handbook/install.html> 

when installing packages, you will most likely have to 
switch *'discs^ Go to Devices in the Parallels Desktop, select die 
CD drive and choose the option Connect Image... 
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Figure 13. Parallels advanced compressor options 


Linux distros are handled wid) similar case: 


n \y 


• Create a new VM widi ihe default Typical VM Configuration. 

• Choose die Guest OS ty|ic (FreeRSD) and ihe version (Other 

FreeBSD since 1 downloaded FreeBSD 6,1, in niy example. 
Get it at http://www.fFeebsd.org), 

• Name the Guest OS VM (FreeBSD) and save the coiiFiguration 

file, 

• In die Property Page, under Configuration, locale the Guest 

OS line under File Dx-ation and click on the Boot Sequence 
link to open the Booting OptiQn.s mb. 


Figure 15. Swap image files when prompted 


After successful insrallarion, you'll .see FreeBSD as your 
Guest VM. 
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^Poofl Three months of work gone because I hit the wrong key,^ 





Just because it’s gone, 
doesn’t mean it’s gone for 
good. Get the hardest working 
data recovery software for 
Mac OS X on the job. 

FileSalvage''^'^ can undelete files 
from your hard drive, digital 
camera or iPod. 

Even if you’ve accidentally 
formatted it or your drive is 
corrupted ... you can still 
get your important files back. 

See for yourself 
Visit www.SubRosaSoft.com 
for more information. 
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Figure 16. FreeBSD virtual machine 


Post Install Euphoria and Reality Check 

Windows Server 2003 ran cjuile fast on iiiy MacBook Pro 
(2.l6 GHz, 2 GB RAM) and iMac (2 Gllz Intel Core Duo, 2 GB 
RAM), i ran SQL Ser\^er 2000, a QuickTime movie, Photoshop 
and varioas Office 2003 applications on ilie Guest OS while 
working in Pireworks, Photoshop, Entourage and Keynote on 
the Mac OS X Host. No delays, screen redraws or other ol:^vious 
hits to performance on either Hast or Guest. 

Both tlie Windows Server 2003 and FreeBSD VMs used tiie 
virtual network adaptor without any re-contiguration. Despite 
being the latest update release candidate (build 1884, as of this 
writing), there are still some USB glitches (some Hash drives and 


HostedStore / 



HostedStore provides a TURNKEY 
SOLUTION FOR CREATING A WEB STORE, 

yet is extensible so developers can use 
the application as a base for creating 
customized solutions for their clients. 



The extensibility of HostedStore provides a 
structure which allows developers to 
create modules that add new functionality 
or alter the built-in features. 



We are seeking software resellers, hosting 
providers, developers, and designers that 
currently offer or plan to offer ecommerce 
solutions to their clients. Resellers receive 
a discount off of the published list price of 
our software and are free to bundle our 
software with thetr own products and/or 
services. 



Wintiows mobile devices were recognized, others inexplicably 
not; several USB drives dial were recognized would not display 
files on the drive), lliis build also boasts compatibility with the 
quad-processor Mac lYo, completing support for the entire Intel 
Apple line. I had a litde difficulty widi networking on a new Mac 
Pro (two 2 GHz Intel Gore Duos, 2 GB RAM) but die Parallels 
Forum (http://forum.pafalle)sxom/) had workaroimtLs posted that 
solved this and a few odier known issues. I'm confident diat 
improvements to support for the Mac Pro will come quickly. 

Setting up printing was simple. Since 1 experienced some 
USB device issues, I tcK)k the easy route and downloaded and 
installed Bonjour for Windows (from 
<http://www.apple.com/support/dovtfnloads/bonjourforwindows103. 
html>), turned on printer sharing in OS X and...it just worked. 

Want to Ixtck up your VM? Just copy die .hdd and ,pv,s files from 
the viitual imchine tliiectory in Vlibrary/PamlleLs/ and you're set. 

One minor inconvenience is that you can’t listen to audio 
CDs and you can’t bum discs from witliin VM’s but 1 don’t 
consider this a deal breaker 

3D graphics siippon is one of the most popular feature 
retiucsts so keep an eye out for future updates to Parallels 
Desktoj:) to accommodate the gaming set. 

Despite tliese few minor issues and inconveniences, 
Parallels DeskU)p is well worth its low price and the benefits of 
dead simple installation, admirable speed, seamless networking 
and - most Lmpojtantly - the ability to switch instantly bem^een 
liosi 05 and guesl VM’s wiiliout a rclioot. 

The Future 

At in August, VMware - the leader in virtualization 

softw'are - announced a Mac pon available later xhis year. 
VM ware's entry into the Intel Mac VM market heals up the race 
ttj provide ctjiiij>lete VM compatiliility, perlbrinance and meet 
feature requesis, It’s always nice to have a choice and it’s 
interesting that companies like VMware, who have a global 
presence, are keen on providing services for the OS X platfonii. 

Early this year, MacTech mn my article on distributed 
computing, and I wrote: "Of note, viiiualizaiion technology is 
liuik into Intel chips wliidi will allow' the machines to be 
partitioned to nm different type^j of software like Windows or 
Linux at once, on lop of Mac OS X. And hardware virtualization 
enables a system to run at near full-speed.’’ WeVe tliere now! So 
whafs next? Will Apple provide native virtualization in 105? Will 
you be able to create a VM through an app in Utilities or tlirough 
a pref pane? The fulure will bring Mac users more djoiee.s and 
more cross-compatibility witli other ot^erating systems, 

_ 
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VeVe been an Intel C++ compiler customer and are 
impressed with the results. We are encouraged by Intel's 
commitment to expand their software development tools 
to support the exciting new Intel-based Mac platform." 

Kevin Tureski—Director of Engineering, Maya. Alias Systems 


Translate Macintosh* MultiCore 
Power into Application Performance 

Get your applications ready for parallel and scalable processing 


Right the first time: 

Inter C++ Compiler for Mac OS* is a highiy optimized compiler 
designed to handle the most demanding applications. Intel augments 
these compilers with advanced support for threading through OpenMP* 
and auto-parallelism capabilities. 

Intel' Fortran Compiler for Mac OS* provides a fast and easy way 

to get maximum application performance for compute intensive applications. 

This compiler supports OpenMP* and auto-parallelism to take advantage of 
performance features available in the Multi-Core Intel* Processors. 

Intel"' Math Kernel Library for Mac OS* is a set of highly optimized, 
thread-safe, mathematical functions that reduces the need for hand-coding ^) 

and allows developers to achieve outstanding performance for engineering, ^ 

scientific and financial applications. 

Inter Integrated Performance Primitives for Mac OS* enable software 
developers to achieve maximum application performance and reduce 
development time. They provide highly optimized functions for math, graphics, 
multimedia, audio, video, speech, computer vision, image, cryptography and , 

signal processing that have been heavily optimized for Intel" processors. 4 ' 


* 2006 Intel Corpora lion, Intel, the Intel logo, Pentium, Itanium. Intel Xeon and 
and other countries, *0lher names and brands maybe claimed as the property 
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Spam Graphing and 
Logging for SpamAssassin 
Rule Optimization 

By Paul T. Amuiann 


During my f eon re as a sysiems adniinifitraior, I noticed 
Lliat admins fall into two disparate groups leased on how they 
approach a problem. 'I'he first group aggressively works 
toward a solution and closure to the prol}lcm, trying any 
potential change lliat migiit make the Tix. Tile other group 
works more merhodically, making calculated adjusmienis and 
reversible changes. IVe cx)fne to appRTtale Ixjili groups, 
especially the former when it’s important to just ‘'get tlie job 
done", but getting a grip on spam requires the more 
deterministic approach. Counting and graphing your spam, 
for example, can help you see just liow big your problem 
might be and how l^est to attack it. 

This article details how to gather statistics on inail ihai is 
filtered through SpamAs.sas.sin, and how to pkA tiiose 
numi)ers with MRTG. Tiiis projea Ix^gan when I decided to 
learn exitctly how much spam 1 received in a given period; it 
grew when 1 found some cxldilies in the SpamAssassin rules 
that miilched most frecjuenUy. 1 sliould add tliat wlten I began 
tills project I had already inve^sted considerable time tuning 
SpamAssassin's Baye.sian database. In my opinion, I his 
remains one of the strongest defenses against spam on a [X^r- 
user basis, liecause what is spam to you is not necessarily 
spam to your neighbor. 'Ibus, leaching SpamAs-siissin to 
recogni;;e whal’.s spam to you, ts important. 

On tliat note, you also should be aware that the 
implementation destrii^ed is designed for a single user. The 
s^'ripis could ea.sily lx edited for use at the domain level. 
However, tlie ohjeelivcs here are to tune SpamAssassin, which 
is difficult to do, and to make global assumptions alxiiit whai 
hundreds of users might concur is spam. The met}u>ds 
descTilxd increase the effectiveness of Bayes filtering by 
finding out wliich ntles are triggered most often. 'Ihis is done 
by counting incoming spam and graphing the numixrs. 

Two direct dependencies are used in tills article's 
features—SpamAssassin and MRTG, Ixith depending on Perl. 
Both packages can easily be installed (see References), rhu.s 
their installation will not be covered here. The projecLs' 
wellsites contain tJiorough documentation as well A 
potential, third dependency might be procmail, but your 
favorite local mail agent can be used to filter incoming mail 
tlirougli SpamAssas.sin. 1 like prtxmail, and will describe how 
1 used it. 


Getting the Statistics 



Tlie first step in implementing this spam control suite is 
having your incoming mail filtered through SpamAssassin before 
delivery, Tliis is where I use pr<x:maiL Tlie ftjllowing line at tlie 
start of your ,pnx'mailrc file in your home directory' w^ill pipe 
mail through SpamAssassin: 

: Ofw 

1 /usr/liin/spame 


Tliis use depends on having the spamd daemtin running, 
which 1 highly recommend for efficiency. If, for any reason, 
running the daemon dtxsn‘l suit you, mail can alternatively be I 
piped to /usr/bin/spamassassin, hut this setup will spawn a | 
clifferent perl/spama.ssa.ssin ptfjc'e.ss for each mail. My home mail i 
.server mns fcLclimail to gel 10 mails |XT call 

This setup alone will do SpamA.ssa.ssin's default aaion.s and r 
tag your mail headers, and prepend the mail’s subject line witli 
SpamAssassin's default “***SPAM***^ While liicsc tags are useful 
to end-iusers, the utilities of this article depend on the X^Spam- 
flag mail header, w^hich contains a Yes/No spam assertion and 
SpaniAssassin’s score based on ius sctjring rules. We'U make use 
of these features by asking prcxmail to do a few more things ii 
with our mail. 

Although it might seem cxld, we’re going to filter the mail 
ihrtmgii SpamAssassin a second time, but this time the custom 
scrifX this article features makes use of the Perl module 
Maih:SpamAssassin::NoAudit, which doe.sn’l deal with the full 
overhead of SpamA,s.sa,ssin. The ncxi release of this project will 
likely eliminate this duality, so check for updates. The following 
shovdd appear next in .proc^mailrc: 


:0c 

I - spaicassa£siii/bin/epajDasfiafi siti_stats. pi 


Also, note that the following procmail recipe was an 
early implerncmation of this tool and worked quite well, but 
then these responsibilities got snarfed into the above script 
for the sake of coasolidation. li nicely creates two counter 
files and delivers mail to a spam inbox file and non-spam 
mail as usual: 
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Automator Actions 


:0 

'^X-Spam-Flag: .‘YES.* 

t 

# deliver to spam mbox file AND inct spam 

counter file 

:0 c 

I echo -n . » .epamasBessin/coiint .«pam 
:0 


jOc 

j echo n . » sin/count.ham 

The spamassassin_stiits.pI script uses the 
-/.spaimissassin/stats directory to keep its count (see Listing 1). 
'Ihere are two files, named counts..spam and counts*ham, which 
rally rheir respective mail types. Additionally, there are twf> files 
to keep track of SpamAssassin scores (scores.spam and 
scores.ham), and two directories (named “spam” and **ham"). 
These directories hold some interesting statistics—a file named 
for each SpamAssassin mle matched with its size, being the 
count of matches. Thus, a simple Is -IS | head in the spam/ or 
ham/ subdirectories can quickly sliow most common 
characteristics in your spam, 'lliis feature alone imy suit some 
admins who just want to cjuickly see some numbers, but die 
graphing used by MRTG really adds .some nice documentation 
of spam abuse. Another quick option is to point your wch server 
to this stats directory (assuming direaory listings are peniiitted). 
Apache has linked column headers, wliich son for that specific 
column. Use diis to sort your stars. 
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your team can send multiple media processing jobs to your server for lightning fast 
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Listing 1; spamassassiu_stats.pl 

Please vlsii ihe MaeTcch Source Qxle ftp for Listing 1. 
<ftp.mactech.tom/src/nfiactech/volume22_2006/22.11 .sit> 

Graphing the Stats with MRTG 

A,s with the common use of METG, the mng i>inary should 
iDe run about every 20 to 30 minutes via cron, l>ut we'U be using 
a cusUim coiifig file named 

.spainassassin/staLs/mitg/spaincount.cfg (see Listing 2), Tliis will 
be the only required argument to mng in your cron entry: 

7/21 * * * * /nsr/bin/nirtg $JIOME/inrtg/spam/i?i}flfnati^tfl .cfg 

Depending on your inllux of mail, it might i>e Ix^neficial to 
reduce this frequemy to dramaike your graphs. 

Listing 2: spamstats.cfg (mrtg config file) 

Please visit the MacTech Stiiirce Code ftp for Listing 2. 

<ftprnactech.com/src/maaech/voiume22_2006/22J 1 sit> 

The spainstats.cfg file can fie extended to create as many 
graphs as you need, hut the file used here just graphs 
incoming spam counts, and the percentage of mail that is 
spam. The reality of these graphs may lie surprising. I was 
shocked and disappointed to discover that i get more than 
90% spam! 


When your customers 
need a helping hand, 
don't you want to be there? 



With Mac HelpMate Pro, 
you're just a click away. 
www.MacHelpMate.com/testdrive 

Mac HeipMate Professional features! 

• lefo<onfiguratton screen sharing (no iP address, no router meaking necessaryl 
tt works through 90% of ftfeivo//s and NATs. Reach arryone in rhe wodd wherever 
they are, wherever you are ,.. 

• Yourcompan/s image and logo on the spiash screen of the application reinforces 
your brand, services and sales offerings a$ wed as generates new opportunities 

- Automated maintenance tasks create billable subscription-based services 

• One unlimited ficense covers instaiiation for all of your customers'worArstof/ons 

• Cross platform: Mac - Moc Mac - Win, Win - Mac and Win - Win 

Mac HeipMate Professionai ^ is a product of MOST Training & Consulting 
www.mac workshops com 


If yoiTre familiar with MRTG, you probably know it can 
quickly lx; configured to graph ^xirt traffic from your routers or 
switclies, as it wits designed to do. However, it can also be 
extended to graph almost anytliing. By default, MRTG queries a 
router and expects four lines in return, of which the first two are 
llic counts of inbound and outbound bytes, and Lite second two 
are the sysUptime and sysNiime MIB entries. The first two lines 
are completely arbitrary, and can be used to represent anything. 
The scripts called via spanistatsxfg do jiLst this. They get the 
numt>ers via file size tn the stats directory tree and return them 
to MRTG^almosL i(K> easy. 

The initial versions of these scripts also maintained 
overhead, keeping track of the counter files and clearing 
them periodicaliy, but as ii turns out, MRTG takes care of 
maintaining a datal>ase, and has features to reset counters. 
Whether youYe using RRH (Round Rolnn Database, a 
preferred logging mechanism for MRTG), or MKTG's default 
text database scheme, MRTG does all the work of keeping 
track of historical data. This is done by inlegraiing new data 
into historical averages. 

From the perspective of MRTG, this is all that’s needed to 
create the Yearly, Monthly, and Weekly grapiis. If more detailed 
liistoricai data is desired, it can easily !k‘ maintained by a few 
edits to these scripts. However, lite counter files do need to be 
periodically reset. The I'hreshMaxI and ThreshProgl MRTG 
configuration options let us set a counter tliresliold and program 
to reset the vaUtes, respectively, just like your switch's counter 
registers reset wiicn it hits tlie ceiling of a 32-bit register, wcTi 
do llie same. Well set the magic number to 1024 because a 
default I IFS filesystem makes use of a 16K block size. Tliis is the 
numlier to whic:h we’ll configure ThresiiMaxI and nireshMaxO 
to rcsixind. 

To finish the presentation, weT usc^ indexcfgmaker, a Perl 
script that's p^irl of tiie MRT'G distribution. We can feed this 
script, the spainstats.cfg MRT'G config file as an argument, and 
it’ll generate appropriate html for an index.htiiii file containing a 
list of all the monitored objects in tabular format with the five- 
minute averages graphs. Tliis provides a quick overview of the 
current status. Clicking on any graph will take you to that 
monitored ohjecT’s full [jage with die Weekly, Monthy, and 
Yearly graphs. 

Tuning SpamAssassin 
for Better Filtering 

Now that we can "^see" oor spam from a higher perspeaive, 
SpamAssassin can tuned for lietter filtering. The defiiult 
values that SpamAssassin gives to rules are configured in 
/etc/maii/spaniassassin/loc:aI.cf. When I first liegun filtering my 
mail with these scripLs, I was surprised to see how many mails 
st:ored liighcr dian the Bayesian 90th percentile. 13y increasing 
the weight of frequent culprits in my .spamassassin/u5er_prefs 
file, I also increased liie iiumlxr of mails matched above the 
90th percentile. Likewise, if you find you never get any non- 
spam mail hitting above the 30th Bayesian percentile, you can 
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Timbuktu Pro version 8.6 


• Skype Internet telephony integration 

* Universal binary support for Macintosh 

For IT professionals, telecommuters and those on rtie go, Timbuktu Pro is 
the award-winning standard in remote control technology for access to 
remote Windows and Macintosh desktops on LANs, WANs, the Internet, 
or through Skype telephony connections. For nearly 20 years, Timbuktu 


Choose how Yoo want to ifiaosge yotir 
computer network and commimicate 
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machines from anywherel 
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cT.)mf<)nal)ly sei [he Bayesian watermark to 70 iastead of the 
default of 99- Here are some of my .sparnassassin/user_prefs: 


score adjustments 

score DATE_rN_FUTURE_03_06 5.0 

score INVALID_DATE 3.5 

score DOMATN_SUBJECT 2.5 

# trigger and bayeelan learning thresholds 
r eq u 1 r ed_bi1: s 3.5 

atito_learn_threshold_sparo 7 


The roohs of this project began with filtering my 
personal mail, and I have been conLinually tempted to try 
tliese utilities at the server level (I haven’t yet). However, 
it seems most anti-spam whitepapers emphasize the point 
that Bayesian fillerijig is strongest per user Although, I 
would expea the graphing to be helpful at the server 
level, I would alstj anticipate that one small change to 
benefit tme user's spam problem might create false 
positives for another. 



Figure 1: avg_spam_score"day 



Figure 2: myhoslpct spam-week 


Conclusion 


Affordable, Apache-based Webserver software, 
accessible from all major Mac and PC browsers, 
for customer image reviews and approvals. 


SeeFile lets you maintain private logins to different 
folders, and manages all permissions for uploads, 
downloads, previews, watermarks and messaging. 



pro photography 
prepress 
archives 
videos 


If you've been using MRTC to track router traffic, 
you 11 likely agree as to the convenience of seeing this 
information graphically. Many sys admins are already 
overtaxed with re.spansibilities, thus the more utilities 
we have to see what our system is doing, the l)erter 
And, while most of us pride ourselves in being able to 
find almost any system stat from the command line^ it's 
undeniably helpful to have graphical tools. 

An extended liope of mine is that this suite of 
scripts can lielp legislation catch up with the spam 
epidemic. Although spam provides a lot of job security 
to sys admins, I think we would all prefer to see it 
disappear, .so we could work on bigger and better 
things, I hope these graphs can be used to show 
management and ptjlkieians how badly some of us are 
plagued by spam and thereby losing productivity. 


VlWW.f^MCTECH.COM 

























D 


TM 


««= 


PHONEPIPE VOIP Service 


Residential Plans 


The PhonePipe 500 
$14.99 

500 Minutes - US and Canada 

*Additional Minutes 3.5 cents 


The PhonePipe 
Unlimited 

$24.99 

Unlimited Minutes 
US and Canada 


The PhonePipe 900 
$19.99 

900 Minutes Canada, Austria, Belgium, 
Chile, China, Denmark, France, Germany, Hong 
Kong, Ireland, Italy, Malaysia, Netherlands, New 
Zeatand, Norway, Singapore, South Korea, Spain, 
Sweden, Switzerland, Taiwan, UK 

^Additional Minutes 3.5 cents 


The PhonePipe 
Unlimited International 


$34.99 


Unlimited Minutes *"US> Canada, Austria, 
Oelgium, Chife^ China, Denmark, France, Germany, 
Hong Kong, Ireland, Italy, Malaysia, Netherlands, 
New Zealand, Norway, Singapore, South Korea, 
Spain, Sweden, Switzerland, Taiwan, UK 


*Alt Plans Include Caller ID, Voicemail, and Three-Way Calling 


Base Line 

Starting at 

$20.00 a Month 

includes: 
eVMeCailerlD 
•3-Way Calling 
•Call Forwarding 
•Call Waiting Plus 

*Long Distance Starting at 
2 Cents Per Minute 


Business Plans 


Enhanced Line 

Starting at 

$30.00 a Line 

Includes: 

*Basic tine Features 
* Microsoft Outlook integration 
•Find Me-FoHow Me 
* Simultaneous Ring 
* Personal Web Portal 

*Long Distance Starting at 
2 Cents Per Minute 


Unlimited Line 
$49.99 a Line 

Includes: 

* Enhanced Line Features 

* Unlimited tong Distance 

to US and Canada 


‘tong Distance Starting at 
2 Cents Per Minute 


“All Business Lines Include PBX Features: Call Transfer, Music on Hold (Customizable}, Call Hold, 4 or 5 Digit Diaiing 

Optional Features: Auto Attendant, Call Center, Reception Console 


www.PhonePipe.com 
1-877-300-3035 Ext 8200 
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Stroighf'isecorid tolfEglincrements 

Excellent rotes on introstote, introlota/toll colls 
and internotionol colling with no term contract. 

Toll Free (800/888/877/866) service, 
some low per minute rate for Incoming colls. 

10 cents per minute calling card. 

Detoiled billing direclly from OPEX. 

Quality electronic and telephone customer support. 

No minimum or monthly fee with 
electronic billing and payment. 

[NOTE: S2.00 billing fee is charged when your bill is under S20.00.} 
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Managers and politicians may be more receptive to 
statistical complaints, graphs, and pie charts than other 
forms of information* 
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G3/(34 PCI/AGP : $129 4^ 

G4 Gigabit/0 Audio: $199 
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Power Supplies 


the, mac. resource 


Wireless Products 


Airport Cards 
Extreme: $69.99 
Standard: $199.99 
Routers: $59.99 


G4 iMac 15/17/20; $79/$99/$119 
G5 iMac 17/20: S149/$179 
G5 Tower: $ 1 69 / $ 1 99 
G4 Qstlver/D audio:$179 
G4 Gig E-net/MDO: $199 
G4 AGP 208/237W: S179/$219 

tftflc baard antf twppllvi rnqulrv tnchtni* 




G4/G5Processors 


LJ ^ 
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and Xserves 
pricing 


iPod Minis from $129.99 
20 Gig from $159,99 
30 Gig from $179.99 
40 GIG from $199.99 
60 GIG from $239.99 


Thousands of parts 
in stock for all 
Mac systems! 


733Mhz 5599 j I 

SOOMhz: 5649^ 
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1.6Ghz: $899 
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iMac G4s $399,iMac G5 1.9Ghz 17’ $999 
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Intel Dual Core Demos from $849!!! 
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How-to: Triple boot a Mac 
with Windows and Linux 


By Criss Myers 


Preface 

Apple Mac:'s niigration to InteFs XB6 Architecture in January’ 
2006 presented a unique o[>poituntiy diat, in tlieory, enableci any X86 
OS, l:)e it Solaris, Unix, Linux or Windows ro nin on Apple Maeiniosfi 
hantware. Finally the Ixirriers Ixlween linux, Mac and Windows 
were lMX)ken down ;ls eacli could be run natively on the same 
macliine, billowing a like-for-like comparison of OSes and hardware. 

Arcliitcctural differences between Apple’s 
X86 machines and otlier X86 machines 

Tliere ane, however, a few teclinical issues Lliiit need to l)e 
overcome LtJ enable a Mac Intel machine to be dual or triple Ixioted. 

Firstly, Mac uses tile Intel Core Duo chip wliic:h uses Inteis 
advanced KFl (Extended Firmware Interface) to Ixk) 1 the operating 
system, a system already used by Intel's Itanium systems and far 
moR" advanced than the much outdated BIOS developed in the 
1980s. Micrceoft s Windows XP and their Future OSes siK:h its ilie 
long aw'aiied VisUi will not use EFI for some time. In April 2006 
Apple launclied a Fimiware update to EH for all Mac Intel 
Machines that ;dlow^ the EFFs in-built chooser to see Winckjws 
legacy bias bool setiors and Ixxit diem. An open source projeci 
culled rEFIt can see all legacy bios sectors and identify tiiem as 
either Windows or linux and even recognize bcKM .seaors on 
external drives as well. This project can Ixi eidier irLstallcd onto die 
Mac OS paititkin, and lilessed so dial it can he die default boot 
partition, or burnt on to a CD and Ixxited from there, 'there is also 
now a “Start up Item*’ which keeps rEFIt active across Mae OS X 
UfKiates and pmvenLs [irohlems with Safe Sleep. 

Secondly, Aj:>pJe opted to use the more advanced parddon table 
called GPF (GUID pfirdtion table) as opposed to ^fBR Cmasier IxkH 
record) ilmi rno-si txher OSes use. Winck)ws XP, Vista and Redllat 
Enteipilse Linux use diis M13R, the problem is therefore that these 
OS's w*^il] not te able to lead or mount the partition.s if tlw Mac hard 
driv’e is formatted as GPT, OS X Ls not able to a-ad MBR tables. Fnxti 
mlease 10,4.5, Apple’s Disk Utility can fomiat and create both MBR 
and GFI’ but not both together Windows partition tool can only 
create MBR, linux's fdisk can only create MBR and Unux's Parted 
(altemadve partition itx)l) can only create GPT, Tlierefore a Mac 
machine can l>e formatted for single boot of OS X 10.4.5, Windows 


XP SP2 or a linux/Llnix distribution, but to ciR-ute a GIT / MBR dual 
IxkM miichine would [le a prolrlem. To solve tliis prolMem Apple 
updated tlieir DLsk UtiEty In OS 10,4.6 to cremate a GFF table and 
then mirror it to an MBR table, so ifiat Ixah OS's could mad iL Uiey 
incx>rporatetl tfiis into their BtxxGuiip lx.‘ta, wliich wiU later be 
incoqxjmted into OS 10.5 Leopard, 

Apple created BootCamp to eRible the installation of Windows 
XJ^ on to a Mac as a dual I'xxa setup. IkxxCamp finjily creates a 
Windows Driver CD for tile [)uiticukir hardwam it is running from, 
dien it allow^.s the u.ser to partition the Mac hard drive into 2 
partition.s without reformatting the drive (via a GUI to the a>nimand 
line dLskiitil). It then rebcxjts die Mat: from the Windows XP SP2 
disk, Bcx>tCamp can also rcstoie tile drive to a single partition again. 

A Mac machine cannot be dual or triple IxxXed straight out 
of the box. Some of these technical issuc.s, however, have l>een 
solved by Apple in resjKinse to tlie cu.stomers desires to dual 
Ixxil tiieir Macs. There are also a few Linux thstros that have 
lieen adapted to work on Mac Intel, such as Debian and Lfountu. 
However until tfie next version tjf RedHai Enterprise Linux is 
released there is no current version adapted for Mac InteL 

So to dual boot a Mac for OSX Tiger and Windows XP is 
easy, Apple has done all the work and created aU the tools to 
do it, the problem comes when you need to triple boot. 

Tliere are plenty of resources online to guide you through 
dual booting a Mac with OSX and Windows Xl^, Apples 
BooiCamp section of ilieir site has lots of information. 

<http://www.onmacnet> 

<http://www.maconintel.com> 

<http://http://fedoraproject.org/wiki/FedoraOnMactel> 

All of these have infr>rmation on dual tooting a Mac, but 
very limilcKl mfornialion on triple Ixjoting. 

As pointed out by the fedora projeci: 

“Right now, w^e’ve only tested Dual B<xXing with OS X. if 
you w'ant to Triple Boot, you're going to have to do some 
investigation on your own.” 

'lliere follows a step-by-step guide to triple booting a Mac 
Intel with any dislribulion of Linux. 
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if Cyour_website_stats == ???) { 
try_visistat = free; 
setup = no_brainer; 
web_stats = !!!; 


} 


else { 

no_clue = true; 

} 

//REAL-TIME WEBSITE TRACKING 
goto = www.visistat.com; 







Hardware and Software Required 

Here are the items we need to accomplish this: 

• Mac Intel machine, any model. 

• OS X 10.4.5 Intel Install DVD that came with the machine. 

• Firmware Update, for yoiir particular hartiware, NOT the SMC 

update (check your firmware 

<http://dco.info.app[e,com/article.html?artnum^303880 >) 

• Keyboard Update for Mac Intel, released 04/27/2006. 

• OS X 10,4.6 Intel ComboUpdaLe, released 04/03/2006. 

• BoolCamp Beta 1.1 

• Windows XP Seivice Pack 2 Install CD 

• Linux - RedHat Enterprise Linux V4 update 3 Install CD’s 1-4 

• lJl>untu LiveCD for Mac Intel this lias Ixiilt-in drivers for USB 

devices ( 

<ht^://sourceforgenet/projGct/showfilGsphp?gfoup_ki=160126£ipackageJ 
d-181927>) 

• rEFI Toolkit, (http://r€fit.soyrceforge,net/) 0.7 ISO version. 

• USB Fen drive 

• tJSB Hard drive, DOS formatted 

3his guide presumes that the reader will have a [}asic 
knowledge of Linux, the command line, and how to boot from 
non Mac install CDs, 

Step 1: Preparation 

Install 10.4.5 that came with the Mac, connea it to the 
internet and download the following from the above links : 


Firmware update for your particular model. NOT the 
SMC update. 

“ Keyboard upeUtte 1.0 

-10.4.6 Intel Combo Update 

- Bcx)tCamp Beta 11 

Download the following files and them bum u> CDs: 

- Ubuntu LiveCD 

- Linux - 1 am using RedHat Enterprise Linux 4, Disks 1-4 

- rEFl Tools 07 ISO 

From the Linux install disk 4, copy lilo.rpm to tlie USB pen drive. 

Install any required rirmv.'aie update, then insiall 10.46, do not 
install 10.4.7 otlierwise you will not be able to install die Keylx)ard 
Update. lasDll the Keyboard Update, which will prevent the 
Keyboard from being unresponsive when IxxXcd from die Linux CDs. 

Wc will now create an XP Drivers CD. To do this, install 
BootCamp beta and then create tlie drivers CD for your 
particular hardware from the BcxitCamp menu. If BootCamp 
dex^sn’t recognize your Firmware update, Apple suggests you 
install 10.4.7 Comlio or reinstall BootCamp. 

Step 2: Creating a working Linux system 

Wc are now ready to l^gin the triple IxxDt process. Even 
tliougli we can paitition tlie drive into 3 partitions we tiinnoL insUiU 
Linux directly onto the .second fxirlilion. This Ls due to the fact that 
when we partition tlic drive it will create a GPr record and an MBR 
minored record. Window's XP will simply ignore the GPT rearni as 
it has no understanding of what a GPT record is. RedHat Linux’s 
installer Aixiamda, however, Ls more sopliisticated and will 
recognize die GPT record, but because it atnnot install onto a GPT 
drive it will then try and a^formai the drive. This maylx; a firoblem 
with many odier disLributioas of Linux and Unix. As we know that 
die only formatting tool diat can support both MBR and GPT 
together is Apple's cILskutil we have to fixmal the drive under OS X 
We will work around tliis piToblcm as foliaws. 

Boot die Mac from die Linux install CDl and when asked to 
partition die drive do so Jimnualiy and cneatc a single root “/” 
partition widi the same size as dial wliich you intend to use for your 
final setup. 1 am using an 8(X313 haid drive so 1 will use 15GB for 
Windows, 15GB for Linux and the remaining for CSX, this means I 
will create a 15GB rtxx partition wliidi will lx; called sdal (Mac Intels 
U.SC Serial IDE drives so they get the names sdal, sda2 ere rather than 
lidaL) Do not aeate any logical volumes or swap partitions. 

When prompted, do not install any l>oot loader, as we 
canntsi use GRUB on Mac Intels: it will hang at Stage 2 of the 
boot process. LILO is tJie only boot loader that works. LTI-O is 
not a default option under RedHat‘s Anacxmda, and therefore, 
we will install tiie bootloader later. If your distribution of Linux 
allows you lo install ULO then install It on to the root partition 
not the MBR, Finish tlie installation and skip the next part and gc^ 
straight to rebooting from the rEHi disk. 

Install the rest of Linux to your requirements as per normal. 

We will now install DLO. Boot the Mac from the Ubuntu 
LiveCD, connect the USB pen and copy lilo.rpm from the USB 
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Let Phlink take the call. Personalized greetings, voicemail, notifications, and much more. 



Ovolab PhHnk H the ultimate message 
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to email as AAC audio attachments. 
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pen drive (sdbl) to the Linux partition sdaL Reboot from the 
Linux install CD and enter the rescue mode, chroot to 
/mnt/sysimage, then install tlie ULO RPM. Reboot again from the 
Ubiinm LiveCD, mount the Linux partition /dev/sdal as 
mnl/linux and create the following LTT.O configuration file in 
/mnt/linux/etc/lilo.conf: 

boot“/ d&.vl sdal 
ma p=/ mnt/ liniJx/botJt /ma p 
lrLStall=/iimt/linux/boot/boot *b 
default=Linux 

hun 

itnage-Zuint/linux/boot/vti3linuz-2.6.9‘34.EL 

initrd“/iiiiiit / llnux/ boot/ initrd - 2.6.9 * 34. EL. inig 

label=Linux 

root=/dev/sda] 

read-only 

Install LILO with the following command : 

/mnt/Iinux/sbln/lilo -C /mt/linux/etc/lilo.conf -v 

You should gel confimiation of the ULO install without any errors. 
For Redllat Enteiprise users, change the fstab file in /etc , 
the first part of the first line should be changed from^ 

LAflKL=/ 

To: 

/dev/sdal/ 

Reboot the Mac from the rEFlt boot CD and you should 
now get the Linux partition as a boot option. 

Wc now have a single boot Linux Mac, we will transfer this 
data onto an external drive for later use, 

R(x)t the Mac from the Llbuntu LiveCD, mount an external 
DOS formatted tJSB drive. Copy the raw data from the Linux 
partition to this drive as follows : 

dd if^/dev/edal of=/dev/sdb ba^512 

Tills will take sometime* Many, many long iiours, scj go make 
a coffee* 

Step 3: Install OSX and Partition the drive 

Reinstall OSX from the install DVD that came w'ith the Mac 
as per normal, creating 1 standard partition. Connect to tlie 
internet and run software update to install all the latest updates, 
this will install 10,4 J. 

OPT supports up to 128 paiTitions, but MBR can only 
suppon 4 primary partitions, and GIT am not read extended / 
logical panitions. Windows XP wants to install only on to Cr'\ 
which is the last panlrion, and the first partition will be the EFI 
lx)ot partition, therefore there are only 2 leh, I for OS X and 1 
for Linux, tlius you cannot create a Linux swap partition* This 
should not be a real problem. 

Boot camp can tmly make 2 partitions, so we need to run 
the diskutil command via terminal to create the new partitions. 

'Ihe following command will repartition an 80GB hard drive 
(disk0s2) into 15GB for Windows, 15GB for IJnux and the 
remainder for OS X. 

diskutil resizeVolume disk0s2 44.2G Linux RedHat EL 15G MS 
DOS WlndowsXP 15G 


Step 4: Install Windows XP 

Boot from the Windows XP Service Pack 2 Install CL), 
Install Windows XP as usual on to C:/ (the fourth partition), 
Apple recommends that you formal as Fat32 rather than 
NTFS but I have had problems with both formats. If you 
format as NTFS you will not be able to write to this drive 
from within OS X. 

Reboot into Windows XP, insert the drivers CD and install, 
then most of the hardw^are will work under XP, You now have a 
dual bool Mac* 

Step 5t Install Linux 

Boot from the Ubuntu LiveCD, mount the t.lSB external hard 
drive and copy the Linux system back to tlie tliird partition, 
sda3,as follows : 

dd lf=/dev/sdb of=/dev/sda3 bs=512 

Once transferred we will need to make minor changes to 
the LflO h(x>lloader and the file system table fstab, so that we 
can load Linux from sda3 rather tlian sdal as previously* 

1. Edit the fstab file and change sdal to sda3r 

2. Edit the LILO conOguration and change sdal to sda3. 

3. Install the new Ll!*0 configuration with the following 
coniEiiand : 

4. /mnt/liniix/sbin/liio -c /mnt/linux/etc/lilo,conf -v 

5. Reboot from the rEFlt CD, select the Linux partition and it 
should load normally. 

You now have a working triple lxK>t Mac running OS X 
10.4*7, Windows XP SP2 and RedHat Enterprise Linux 4. Tliese 
will all run normally as if they were running from any stamlarcl 
X86 hardware. You can eitlier txx>i using tlie rEFlt CD or you 
can install it onto the Tiger partition. Then each time you boot 
you can select the appropriate OS, or wait for it to time out and 
boot into 05 X. 

Conclusion 

In this guide we installed Redllat Enterprise Linux but 
the same proce*ss should work for any version of Linux 
lKK)ted via LILO, tlie ,same should also work For Solairs and 
Unix but may need tweaking to resolve the change In bootup 
from .sdal to sda3. 

Till 
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Subversion and XCode - 

Source control management on XCode using Subversion. 

By Jose R.C. Cruz 

Introduction 


Since its release, tlie MacOS X platform uses CVS as its 
default source control management (SCM) system. This tool 
is used for tracking changes made to a project as well as for 
coordinating efforLs and contributions from otlier users. It is 
not, however, without its shortcomings, its inability to handle 
non-ASCll files and lack of support for binary formats has 
been a st;)urce of frustration for many users. Furtliermore, 
some actions such as reversions and conflict resolutions are 
less than adequately implemented in CVS, 

To address these limittidons, the r)pen-source community 
developed Subversion. This article will serve as a concise 
introduction to the new tool, it will detail how the tof)I 
improves upon CVS as well as provide an overview of its 
repository structure. It will denionsiraie how to use die tool to 
perforin basic SCM operations using the tool as well as how it 
integrates with the XCode development environment. 

Readers are expected to have a working knowledge of 
XCode as well as the Teniiinal application. Also, most 
examples will use bash as tlie default shell and the 
CurrencyConverier luiorial as the default pR>ject. 

The Subversion Tool 

Ilie Subversion project 

The Subversion (svn) projec't is an open-source project 
focused on developing a viable replacement for the CVS 
tool. Jl shares the same key developers as CVS, and liiis its 
official source repository maintained by CoUabNet, Inc. 

At the time of this writing, s<.)urces for the latest 
development versifin (1.32) are a%^a[lahlc as a downloadable 
tarliall file at <subversion.tigris. arg>. Tlie latest stable 
version of the tool (I3d) is also available at the same site. The 
site also provides links to binary installers for various platforms, 
including OS X Dotli binaries and .sources ate distributed to the 
public under an Apache/BSD compatible license. 

The Subversion Advantage 

Subversion provides numerous advantages over CVS. 
llie most notable one is that all project files, regardless of 
formal, are now stored into the rept^sitory as binary files. 
Also, project subdirectories are treated as valid repository 
items. They can be added, copied, deleted, and renamed like 
any other project file. 

Subversion u.ses a space-efficient liinajy diff algoiiilim to 
store its repository items. This allow's the repository to support 


multimedia files without causing it to grow to an unwieldy 
size. Also, ail committal transactions are now liandled 
aUitnically, This ensures that each transaaion is allowed to 
complete without interruption, and protects the repository 
from comiption caused by simultaneous write accesses. 

Finally, Subversion provides a much better 
complement of subcommands for invoking various SCM 
transactions. Some subcommands such as add, commit, and 
export behave similarly to their CVS cfmnterparts. Others 
such as status, move, and reven are used to perform the 
same operations that would otherwise require multiple 
steps or command options on CVS. 

Installing Subversion on OS X 

The only ntnable disadvantage of Subversion is that it is 
nol i>undlcxl witli any versions of MacOS X. Tliis is easily 
resolved, however, by first downloading the disk image file for 
version 1.3T at <http://metLSsian.com/proj0{Ts/macosx/stjbversion>. 
Make .sure to download only llic client version of tlie tool 
Double-click on the . dug file to mount tlie image on the 
Finder. Locate the SubversionClient-1.30 *pkg 
package and double-click on it to start the installation picxess. 
Follow file ensuing instructions to complete installation. 

I'he installer package will place The Subversion tools 
and support files in the /usr/local directory. In order 
to use the Uxils, the PATH environment needs to be 
updated in order for the shell to know their locations. Use 
your favorite Text editoi' to add the foilowang lines to the 
hidden ,ba3li_prof ile file on your home directory. 

PATH=Us t/local /man: / use/local/share: $PATH 
export PATll=/usr/local/bin: /usr/local/lib: $PATH 

To test to see if Suliversion is correctly installed, type svn 
-help at the Terminal prompt. Subversion should display 
its version and a list of all available subcommands. 

The Subversion Repository 

Creating the repository 

Like CVS, you will have to create an empty repository 
wherein which to store your project archive. First add the 
following line to the ,bash„profile file using your 
favorite text editor. 

export SVNR OQT=ptitbJojfOur_reposi(o)y 
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Then type svnadmin create $SVNROOT at the Terminal 
f)rc>tnpt IQ create the repository. 

For example, to create Subversion reprxsitory to be located 
at /Users/Shared/SVN, the entry for the *bash_profile 
nie should read as 

export SVKKOOT-/Usere/Shared/$VK 


Then, by typing svnadmin $SV!JROOT creates an empty 
repository at the specified location, Tf the SVN sulidireclory does 
not exist, the svnadniiri tool creates one at the specified path, 
However, if the enclosing directory /Users/Shared docs not 
exists as well, the tool will instead generate an error 

Unlike CTS, Subversion does not maintain a default 
repository path. In fact, it allows you to access multiple 
repositories at a time, 'ihe SVNROOT shell varialile inlixxiuced 
here helps reduce the amount of typing necessary to invoke a 
Subversion sulKonunand. 

Figure 1 shows the directory structure of the newly created 
repository* It consists of a numl>er t)f configuration fdes and 
scripts, as well as eight sulxlirectories. ITie only one of interest 
in this article Ls the db sulxlirectory. For a detailed description 
of the other repository items, read Chapter 5 of the Subversion 
aser manual 

The db sulxlireclory Is where Subversion maintains your 
project archives. It contains tlinee subdirccLories as well as 
additional support files. F^ich project archive iwision is sioreti in 
the revs sulxlireclory. Properties for each archive are stored in the 
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revprops sulxliimory. The transactions .subdirectory Is 
used to contain files r^uired by an SCM transaction. Tiiose same 
files one then remcweil when that iraasaedon completes itself. 

By default. Subversion uses Berkeley DB as the format for 
its repXBitory database. Interestingly enough, ihc MacOS X 
version uses FSFS, alst) known as The fVersionedJ fitesystem, as 
its database format. Tills fonnat lias the advantage of being 
platform agnostic and multi-user friendly, it also pnjvides Ix^tter 
I/O performance by taking advantage of the underlying native 
filesystem. Furthermore, it allows the rejX)sitory to be accessible 
over a network connection. 

For more information on the two repo,Hiiory formais, read 
Chapter 5 of the user manual. 



Figure 1. The SVN Repository. 


Adding a project 

Before adding a project to die repository, make sure to 
arrange its directory contents as shown in Figure I. Tlic trunk 
subdireaory will contain those files representing the main 
development line of the project. This is where you will have 
your images, plists, nibs, source, and header files, a.s well as the 
sulxlirectories used to organize those file's. The branches 
subdirectory ts where Subversion stores the branches created for 
each file. Branches that were unaltered and destroyed are stored 
in the tags subdirectory. 
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Figure 2. The recotninended SVN project layout. 

TTiis directory strucLure i.s recommended only if you are 
mainiiiinin^J a central repository to store your projcci archives. If 
you arc maintaining separate repositories for each project, tlien 
you may choose not to adopt thus stnimre. 

To add a project to the repcjsitory, type 

svn import project_dim:t()Fy’ name iiletiN$S^f}^9Wlllm)Jea_name \ 

-m ^imtjeciJmiMtn messagje" 

ai Uie Terminal prompt. Notice that the repository patit is First 
preceded l)y the URL token file://. This indicates the 
repository is located in itie surntf Jibysicai tmichim as tlie 
pnjject. If the repository were located over a network, its path 
would then lx: preceded by either an http:// or svn:// 
token. For more infonnation on how to setup a nem^ork 
repexsitory, consult Chapter 6 of the user manual. 

For example, to add the CurrencyConverter project to die 
repository, first navigate to the directory containing the projea 
using the Terminal application. Tlien type 

svii iiupgrt CurrencyConverter 
f1le r//$ SVNROOT/Cur r encyCo nve r t e r \ 

-n ’"Adding the Currency Converter tutorial demo" 

at tlie prompt. To check if the projea was successfully added to 
the repository, type 

svniook tree SSVRROOT 

at the prompt. Subversion rcsptjnds by displaying the tree 
structure of each archived projects (Listing 1), one of which 
belongs to CurrencyConverter. 

Listing 1. Sample Subversion tree structure. 

/ 

Currency Conve r t er / 
trunk/ 
main.m 

ConverterCont roller.h 
Converter.m 
currCnvrt.phproj/ 
aUser.pbxuser 
project«pbxproj 


Conve rterController .m 
Converter.h 
English,1proj/ 

TnfoPl1st *Sttings 
MnlnHenu.nib/ 
objects.nib 
InfOtnib 

keyedobj ects.nib 
classes,nih 
HainHenu'“.nlb/ 
objects,nib 
Info,nib 

keyedob j ects ,iilb 
classes.nib 
branches/ 
tags/ 

Now to remove a project from the repository, type 
evti delete fne://SSVNROOT//OT>J<?c/_m/m(? m “mmonsjfyrjremm'ar 

at die Tenninal pnmipt. .Subversion will then quietly delete all 
references to die projea fmm its reptxsiiory. Also, typing svnlook 
tree $SVNROOT will show tliat the pirofcct is no longer 
"avaiiahie”. Since deletion also iJivokes an immediate committal, 
make sure to provide an appix)f)riate message for the revision log. 
Otherwise, Subversion will tiot process the deletion retiuest. 

Unlike in CVS, the svn delete subcommand only 
removes die latest t>r head revision of the project. Previous 
revisions of the project are still present in the repo.sitory and are 
accessible for checkouts. The only way to completely remove 
the j>roject is to create a replat:emenc repository and restore it 
from tlie last backup file created i)cforc that project was added. 

Backing up the repository 

One Subversion feature dial was not mentioned earlier is its 
ability to create repository tiackups. Equally important, it c^an t:reate 
these backups without having to take the entiie repository" offline. 
One way to backup the repository is to type 

svnadmln but copy $SV¥R0DT hacktilijUrectoryJfaW 

at the Tenninal prompt Subversiem will copy the entire 
repository located at SVNROOT and place rt at the specified 
directory. For example, typing svnadmin hot copy 

SSVMOOT /Users/Public/Backup creates the backup 

copy at /Users/Publie/Backup, Make sure the backup 
directory exists; otherwise, Subversion will generate an error. 
Another way to backup the repository is to type 

jsvnadniin dunp $SVtJRCK)T > bacJsupJle 

at die Terminal prompt. Here, Subversion stores the entire 
contents of its repository into backup_file. The format used 
by the file is portable and platform agnostic, making it a suitable 
way of moving the repository from one filesystem to another. 
You can also create incremental backups by typing 

svnadniin dump $SVNROnT -Incremental > backupJPe 

at the prompt. The option -incremental tells Subversion to 
retrieve only those changes added to die repository since the last 
complete svnadmin dump. The resulting backup file will be 
smaller as a result. 
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Uestoring from a backup is equally straightform^ard. If 
svn admin hot copy is used to create the backup, the same 
sul)cominand can be used to do the restore by switching the 
positions of SVNROOT and the liackup directory path as follows 

flvnadffiiT] hotcopy backup_direct:ory_path $SVHROOT 

Make sure to take the old repo^sitory offline and delete it before 
replacing it with the backup copy. 

If you used svnadmin drnnp to backup the repository, type 

svnadmlii load SSVNROOT < backiipJite 

at the Terminal prompt to restore the reposiujry from 
backup_file> If incremental backups were made, make sure to 
restore each backup file in tlie same onder tltat they were created. 
For example, if you Ixicked up your repository' as follows: 

svTiadwin dump $SVNR00T > 20060601 »bak 

svnadiniii dtiaip $SVMROOT ’'Incremental > 200606lO.bak 

svnadmia dump $SVNR0OT -incremental > 20060620♦bak 

you should restore your repository in the following sequence to 
avoid data corruption. 

svnadmin load ^SVMOOT < 2006060l.bak 
svnadmin load SSVNROOT < 200606IO.bak 
svnadffiin Load SSVKROOT < 20060620.bak 

The Subversion Work Cycle 

Figure 3 illustrates a basic Subversion work cycle, 
Sulxommands that are marked in red represent those SCM 
transactions supported by the XCodc environment, ITie rest 
should be invoked within the project directory through a 
Terminal session. They could also be invoked thrtjugh the 
XCode Script menu. More on Subversion menu scripts will be 
discussed later on. 



Figure 3* The Subversion work cycle. 


Checking out a project 

Like CVS, you first liavc to check out a copy of a project 
from ilie repository' in order to work on it. To check out a 
working copy, type 


svn checkout filei//$SVNR00T/project_narae 
destination_dii: 0 Ctory 

at the Terminal prompt. Subversion will list each project file and 
subdirectory that was checked out, and places them at the 
specified directory. For example, typing 

svn c he c knut f 11 e: / / $ SVNROOT / Ctir r enc yConver ter 
*/Cnr ren c yConve rt e r 

places the Currency Con verier project in the home directory. 

Interestingly enough, Subversion does not provide the 
equivalent ofaevs release subcommand. Once you are 
done with your working copy, the only viable way of releasing 
il, Ls to manually delete your copy. 

Updating the project 

Like CVS, Subversion allows a team of users U> work on the 
same projea. If you are part of a leam, you should always 
update your copy of the project on a regular basis. 'Ibis allows 
you to caLcli and resolve any potential conflicts l)ciween your 
changes and theirs. 

To update your working copy to the latest revision of the 
project, type svn update at the Terminal prompt. To update it to 
a s/Hxi/ic revision, type svn update - r revision_nimber at 
the prompt. 

For example, if Jtdm Di>e has submitted his revision of tlic 
source file, Converter .in, first use the Terminal prompt to 
navigate to your copy of CurrencyCtinvcrter Tlien type svn 
update at the prompt to update your copy of Converter .m 
to the new revision. 

Consequently, if you want to find out which projea fUes 
have been recently cfianged, type svn status 
ptoject_n3me at the Tenninal prompt. Subversion then 
generates a list of hies and subdirectories with their current 
repository state. To display additional status information, type 
svn status -v projfect_name at the prompt. 

If Subversion detects any conflicts between your working 
copy and the projea archive, it generates three different files 
containing the ctmflicting changes. I'he .mine file ctmtains 
those changes you have made on your working copy. iTie 
, zold_revision is the revision of that file from the archive 
before you made your changes. 'Ihe ,Tnew_revision is die 
revision of same file from the archive while you were making 
your changes. Like in CVS, you manually examine each file and 
attempt to resolve the conflict imnually. After you have 
resolved the conflict, type svn resolved 

pro jeGt_file_name at the Tenninal prompt to clear the 
conflict flag. Oilierwise, Subversion will not allow you lo 
commit your changes back into the repository. 

For example, if your copy of Converter .m file, checked 
out at revision 3, conflicLs with die latest revision (4) in the 
archive, Subversion generates the following three files: 

Converter,mine Converter*ri Converter,!^ 
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Use yt)ur favorite text editor to manually examine and mei^e the 
conflicting cltanges. Once done^ type svn resolved 
Converter,!!! at the prompt to clear the conflict flag. 

Manipulating project items 

Subversion allows you to easily add a new projea item, like 
a file or subdirectory, to the repository^ archive, Furthermttre, if 
tlie item happens to l:>e a subdirectory containing additional 
items. Subversion will also add those items as well. 

To add a new item to the lepositorv’, type svn add 
projfect_iteia_name at the Terminal prompt. For example, if a 
CurrencyConverter.icns file has been added to the 
CiirrencyCon verier project, type svn add 

CurrencyConverter .icns to add that file to tlK^ refxxsiiory 
archive. Also, if the project bundle, CurrrencyConverter, pro j, 
was convened to the new XQxle 22 fomiat, thus changing its 
extension to ,xcodeproj, type svn add 

CurrencyConverter. xcodeproj at the pn>mpi. Since a Ixindle 
is essentially a specialized sulxJirectory, Subversion will add the 
siilxlirectory, including tlie tliree files it contains, to die archive. 

Subversion also makes it easier io copy, move, and 
delete existing project items, and then submit those changes 
hack to the repository archive. To create a copy of an 
existing file or subdirectory, type svn copy 
projec n&w_name at the Terminal prompt. 

To move (or rename) the file or suhdirectoiy, type svn 
move project_i tem_riame n&y_name at the prompt. To 
delete it, type svn delete proJp.ct_item_name. 

Subveuiion Itandles all four reciuesis by first queuing them into 
its transacikm queue, Tlien, on the next ammiittal tonsaciion, it 
cxec\ites each request in the oaler they were .submitted. In the case 
of a copy, move or delete tnmsaclioix Subverskm will peifomi the 
operation on the working copy of the project as well. 

Committing and discarding changes 

As in CVS, committing changes imde to the project back into 
the Subversion repository^ Ls a straightforwaid pnexess. Simply lyjx^ 

avn coimtit project.iten^path -m “mtmttsjorjyfmmittar 

at the Terminal promf>t. Alternatively, to commit all changes 
made to the project type 

fivrt cbtttmlt preject_naiiie "in ^ur_cominittdr 

at die prompt, for example, to commit the changes made to the 
file, Converter . m, type 

svn commit Converter, ra ro 

To commit all changes made to CurrencyConverier, type 

svn commit Currency Converter -m reasmisJbr_cfrtnmitt£U" 

Always provide a brief and concise committal message lo ensure 
an acairate revision history. 

Subversion fiixt chcxks the repository for any committal 
transactions in progress. If none are present, it Itxks die repcBitory 
to prevent fiiture a>mmittais from oilier users, It then prexesses 


your committal request and unlcxdcs die re^xisituiy after a successful 
or rejected committaL In case your committal transaction fails, avoid 
further attempts in order to protect repository integrity. Contaa 
your project admini.stmtor to resfilve the is.sue. 

Discarding changes made to a project item is also equally 
straightforward Type svn revert project_iTBm_name at 
Temiinal prompt to revert to the latest revision of die item in the 
repository. To revert to a sjKxiJic revision of the same item, type 

gvn revert -r mfisimi^namber prf^ea_Uem_name 
at the prompt, 

Exportmg the project 

Finally, Subversion allows you to export a copy of your 
projea archive for public distribution. Like in CVS, the exported 
copy does not contain any administrative flies, thus preventing 
it from being accidentally committed back into the repository. 
Also, Subversion streamlines the piocess by not requiring a 
release tag assigned to the project to be; exported. Instead, it will 
export a specified revision of the project airhive or, if none is 
specified, the latest revisitm of said archive. 

To export a copy of the projea archive, type 

svn export filei//$SVNROOT///rryeri_fi«me exportjdirvctnryjkith 

at the Terminal prompt. To export a specific revision of die 
arctiive, type 

Evn <?xport -r revision .number filet/7$SVNROOT/praycrLn£/fiit^ \ 
exftOFtjlireaGrr path 

at the ]>iompt. f’or example, if you want U> export the latest 
revision of CuiTencyO>nvener, type 

svn export file ;//$SVNROOT/CurrencyCofivert er \ 

''/Proj ects/CurrencyConverter^GH 

to export the project under the name 
CurrencyConverter_GM and in the Projects subdirectory 
t)f your iiome directory. 

It is recommended that you assign a different name to your 
ex|X)rted project. However, if you use the same natiie as the 
project archive, make sure to t:xpori the projea to a different 
directory. *11iis is to avoid the exix)rt process from accidentally 
oveiwriting your working copy of the archive. 

Subversion and XCode 

Since Ixith CVS and Subversion share some of die same 
subcomniancis, XCcxie is capable of su[5[K>rting either one 
through iLs SCM menu. However, many of the SCM operations 
supported by XCode are geared more towards CVS, l>eing the 
default tool. But, with some work on your part, you can 
configure XCode to lake advantage of many Subversion feature.s. 

Enabling Subversion support 

To start managing your XCode projea using Subversion, 
add your project u> the rcjxjsitory and check out a working ct>py 
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u,sin|^ lilt: pi ficedures stated earlier, Open the project into XCode 
and choose Edit Project Settings From the Project menu to 
display the Project Info panel Seleci Sufiversion from the drop¬ 
down list lal>eled SCM System. Click on the Edit burton to 
cliange the Liirreni Subversion tool path from 
/usr/local/subversion/bin/svn to 

/usr/local/bin/svn (Figure 4), If you skip this step, XCodc 
will display an error informing yon that it is unable to kx.'ate the 
Subversio[i tool Once you have set the correct roof path, click 
on the Enable SCM checkbox to set it. 

Project "curfCnv rr Info ^ 

Subveriion Tool Pa«h fusr/local/bJn/svrv 

Figure 4. Changing the SCM tool path. 

Ihere is nothing wrong witli the default tool path of 
/usr/locnl/subversion/biri/svn if you happen to have 
installed Sul>versi<)n at that particular kxntion. However, the ajnent 
Subversion iastaiier uses / us r/local/bin as iLs i nstallation 
director}^, hence the procedure. This could change in fuiurc 
distributions so imke sure m read rhe accompanying release notes 
before installing or upgrading your copy of Subversion. 

The Subversion work cycle in XCode 

As mentioned earlier, XCode uses the SCM menu to 
handle the Subversion work cycle. Each menu item perfonns 


the selected transaction by invoking the appropriate 
Sulwersion subcommand, many of which are showai m I'able 
1. Most of the subcommands invoked work on the latest 
revision of the project archive or its items. Those that work on 
specific revisions will prompt you for the revision number 
through an input dialog. 


Menu Item 

Subcouunaiid 

SCM Results 

svn status 

Add to Repository 

svn acid 

Resolved 

svn resolved 

Commit Changes... 

svn coniinit piojec1Jtem_nanie 'in 
message 

Discard Changes 

svn reveit 

Update To 

svn update -r 

DiffWith 

svn cliff -r 

Get Annotations For 

svn blame -r 

Commit Entire Project 

svn commit project^oame -m 
message 

Update Entire Profect 

svn update proje<:f_name 


zTable The SCM menu items and their SVN 
subcommands. 
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Other menu items will also generate tlie Subversion 
subcommand corresponding to the selected operation, For 
instance, chtx^sing Rename from the File menu to rename a 
project file generates an svn move to rename the same file in 
the repository archive. Chocxsing Delete from the Edit menu to 
remove a projea file (both reforences and UemX generates an 
svn delete, thus removing the fiJe from the archive. 

The Info panel (Figure 5) can also generate the appropriate 
Subversion subec^minands by clicking one of tlie four buttons on 
tlie panel. Each command uses the currently selected project file 
or the project bundle as its input argument, 

The Update button generates an svn which displays 
the log report for the selected item. lhe Compare button 
generates an svn export to iemp<jniriiy retrieve the item from 
the archive. It tlien launches FiieMerge and uses it to compare 
die contents of the exported item with that from the project. Tlie 
Diff button generates an svn diff sliowing die differences 
between the selected item and its archival version. Finally, the 
Annotate button generates an svn blame, displaying the 
revision and author history of the selected item. 

O n ^ File "C<»rtv«rttFCofitrtil 1 er.in* Info 

' TjfQtw ioiW , si^ ' Comimmi 

SUt» UoraDati IauI 14 

T»q Ur«t( 11 
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II Updated the r^poirtoiv 

2 OS/22/Oi A4dtd the Currency CPnnertrf pfO|«Ci. 


Fiipfidme CortvpriprCofihpiletjn 
RtwSKWt 13 

D 418 ZrJ 0 e^ 20 <» IO:S 7 II 6 POT 
Autnof 

UiMiaiod npositoiv again 


f UpdBltT fcofflpatt) T ^ ^ (Annotate^ 

"ci 2 rtiwt 


Figure 5. The SCM view of the Info panel. 

Subversion menu scripts 

Unfortunately, the built-in SCM support in XCode Is limited and 
certainly not acstomiKable, Future versioas of XCode miglit address 
this limiialion by redesigning its SCM support as a collection of 


customizable plug-tns. Each S<]M phig-in would then correspond to 
a specific system such as Subversion, and wexild allow developers 
to fine-tune eadi minsaction in a fasliion similar to key bindings. 

Until than happens, the only way to implement aistomized 
SCM transactions is through the XCode Script menu. This menu 
supports scripts dial are written in most shell languages such 
bash, Pydion, and Perl* It does not, however, supports scripts 
written entirely in AppleScript nor JavaScjipt. 

Ail XCcxie menu scripts are stored in the directory 

/Library/Application Support/Apple/Developer Toole“> 

/Scripts/lO ljs<?r Scripts 

The scripts are grouped into separate subdirectories, each one 
corresponding to a category. For tn,smnc:e, the SCM menu scripts 
ft^atured hea" aa stored in the subdirectory named Subversion. 

li.sung 2 shows one example of a Subversion menu script. Thi.s 
^script first checks the trunk directory of the project lor die iiidden 
subdirectory^ *svn. It then extracts die repository padt and projea 
name from die entries file stoiesJ in die hidden subdireaory. 
Afterwaixis, die script invokes the svn look tree suixoiniiiand 
and stores the resiilLs into the file, avnlook_tree,log. It then 
iLses XQxJe to display die cTJiitenLs of the log fde. A variation of this 
script Ls also used to invoke the svnlook history sulx:ommand. 

LLstiiig 2, Displayiiis tlie repository tree, 

#J /bin/bjish 

# 

Script: svnlookjree.sh 

^ Descriptian: Display ilic tree strmnure iif the jimjea in 
^ tlie Subversion repository 

# 

# — PU UscrStTipi Info — 

^ %%%(PBXNajne^how SVNTax|%%% 

# %%%fPnXInput-None)%%% 

# %%% (PBXOutput=ScpaKitcWmdow) %%% 

# 

update the foUowmg environmental variabJe 
expon PATH=/usr/ltKal/bin;/usr/l<K;»l/lib:SPAIll 

^prepare the hilkiwing shell variables 

SVNURL="urr='‘ 

SVNDIR=’'t)uild/sv'n" 

SVm.OG="$SVNDm/svnlook_trcc.I(>g" 

S VNMR=” $ S VNDi R/svn look_trcc. cit 

#clicck for the following hidden directory 

if [-d“,svn'’J; 

then 

^retrieve the reptwilon' key 
SVNGREP^’grep SSYbriAG svn/emries' 

Btrieve die reptisiion' location 
SVNROOT^'echo SSVNGREP | awk prim S2 T' 

SVNR(X)T='ech« SSVNRtX>T I awk prim S2 )■' 

wmove the URL tag 

SV™00T= echo SSVNROOT | awk TV/”‘I print S2 
^retrieve the project key 
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SVNGREP='^p SSVNIIRl. .svn/eniries' 

^retrieve the project name 

SVMPROJ=‘ccho $SVNCtREP I awk-F='( print $2 )’' 

SVNPRO|='ccho $SVNPROJ 1 awk -FT”‘l print $2 )’' 
SVNPROJ='ccho SSTOPROJ1 awk ■FV’"! NOM=NF-l; print $NOM}’' 

#check for the following directory 

if I !-d SSVNDIR I; 

then 

mkdir-p $SVND1R 

n 

^retrieve die repository key structure 

svniook tree $SVNRCX>T $SVNPROJ -show-ids 1> $SVNLOG 2> 
$SVNERR 
if I!-s SSVNERR ]; 
then 

rm -Rf $SVNERR 

ft 

#constniet the full path to the log file 
SVNI,OG=' pwd7$SVNI.0G 
SVN1X>G='’0S X"' echo tSVNI.OG' 

SVN1X)G=' echo 1 |SVNI.(X;/A//:)‘ 

SVNIX>G=”\"SSVNI.(XA’' 


also used to invoke the svnadmin hot copy subcommand. 

Listing 3- Creating a repository backup file. 

#1 /bin/bas!i 

f Sc ript: 5Vnad!iiin_d\uiip * sh 

Descriptionr Create a backup image of the SVN repository. 

# - PB User Script Info - 

# m{FBXName=Create Backup Image|%U 

# m[PBXTnput=None]%%^ 

# %%% [ pBXOutput=SeparateWindow] 

# update the following eiivirtiiimental variable 
export FATH=/us r/local/bin:/usr/local/lib;$PATii 

#prepare the following shell variables 
SVNTAC=“tepQS='* tfthe repository tag 
SVMRL-^^url-” #thc URL tag 

SVN0UT=3vn'daLe "+l^%d%%H%M%S"\bak //default output f.ile 
SVNHSC=”Save the file ini'* jfoutput prompt 

#check for the following hidden directory 

if ( -d ". svti" 1 t 

then 

//prompt the User for the output path 

SVNBAK='™IPBXUtliityScriptsPathI%%%/AskUeerForNewFileDia]og 
“$SVNMSG" “$3VNGl]T‘*‘ 


^open the file using XCode 
(Lsascript «-APPLESC:RiFr 
tell applicatiqn “Finder'* 

set fderef to get fiJe $ SVN LOG as string 

tell application "XCode" 
activate 

open file nicref 
end tell 
end tell 
APPIJ^SCRIPI' 
el.^ 

echo'lliis project is currently not under SCM by Subversion ” 

n 

A second exanipile of a Subversion menu script is shown in 
Listing 3. "rhis script also performs the same checks as the 
previous one. Afterwards, it queries the user for a backup 
filename and a location w'here to store the backup. It then 
invokes the svnadmin dump subcommand to create ihe 
backup file at tlie specified IcxTation. A variation of this script is 


^validate the output path 

SVNCNT='echo SSWEAK awk -F'7" 'I print NF )’' 

If f "$SVNCNT” -gt 1; 

then 

#al.art the backup process 
#- 

#retrieve the repository key 
SVbiGRIP= grep SSVHTAG . svn/entries' 


//retrieve the repository 
SVNROOT-^echo $SVNGREP ^ 
SVNROOT-'echu $SVKR00T 


location 

awk -F= ‘ I print $2 T' 
awk -F“V M print $2 T' 


//remove the URL tag 

SVNROOT“'echa $SVMOOT | awk -F7/" M print $2 1'* 

//invoke the svnadmin command 
svnadmin dump $SVWROOT q > $SVNBAK 
fi 
else 

echo ''This project is currently not under SGb by 
Subversion." 
fi 


Menu scripts, litswcver^ do have some inherent 
prolilems. Since the Script niemi is enabled only when 
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XCode is displaying a project, it makes it unfeasible to create 
a menu script that will invoke an svn checkout 
transaction. Also, if a menu script contains a call to one of its 
built-in utility scripts, specifically those that displays a user- 
interface, and to the osascript tool as well, XCode hangs 
consistently wlienever it rebuilds its .Script menu. Separating 
those two calls is the only way of avoiding the hang 
condition. 

Concluding Remarks 

Subversion is a source-code management system tiiat 
improves upon the venerable CVS in numerous ways. It 
supports most of the same subcommands while providing more 
relevant ones to do other transactions. It also supports binary file 
formaLs, provides f)etter handling of project subdirectories, and 
has backup and restore features. 

'Hie XCode development environment integrates ratlier well 
with Subversion. Since lioth uses nearly the same SLilxominands, 
XCode was able to use Subversion without any major issuer. 
More advanced Subversion features can l>e accessed ilirougli 
XCode by provkling the appropriate menu scripts. 

(Ed. Note - As shown. Subversion is an incredibie tool, 
But note ibai iEs not only for source code! techs wifi 
he seeing a iot niore Subuerskm in Ibeir future. Also, while 
the underlying principals are imporlant to iinderstaml if 
you ever need a qukk-and-dirty svn check out, or are fust 


pre-disposed to the a new graphical Subversion client 
just shipped for the JUac ZigZig Software introduced 
ZigVersion during WWDC 2006 - after Jose wrote this 
article! Find out more at http://www.ztgzigxom} 
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A Look at Apple's Xsan j 

^ By Paul T. Ammann 


• What Is Xsan? An Introduction 




Xsan is Apple's high-performance SAN file system for 
Mac OS X and Mac OS X Server. 

Xsan enables you to share one or more Xseive RAID 
devices with multiple XServe or Mac systems. With the 
Xsan file system installed, these computers can read and 
write to the same storage volume at tfie same time, Xsan 
includes all tlie software required for a complete SAN 
solution including the metadata controller siiftware, the file 
system client software and integrated setup, management 
and monitoring tools* 

Xsan may be used in a cross-platform environment 
alongside Windows-, UNIX-, and Linux-based systems 
using the ADIC StorNext File System, which is lOOKi 
interoperable with Xsan. 

As of May 2006, Xsan supports vtilume size,s nearly 2 
petabyte in Lsize, 



4I 


RAID 

arrays 


Figure T 



Xsan Storage Area Networks 

A Storage area network is a way of connecting 
computers to storage devices that gives users a very fast 


access to files and gives administrators the ability to expand 
storage capacity as needed without interaipting users. 

An Xsan SAN consists of: 

* Volumes of shared storage, stored on Xserve RAID systems, 

available to clients as mounted volumes that they can use 
like IcKal disks 

* At Ic^asl one computer acting as a metadata controller that 

coordinates acce^ to the shared volumes 

* Client computers that access storage in accordance with 

established permissions and quotas 

* Underlying Fibre Channel and Ethernet networks. 

The following illustration sliows the physical components 
of a typical Xsan SAN. 



Shared SAN Volumes 

Users and applications see .shared SAN storage as local 
volumes* Xsan volumes are logical disks made up of groups of 
RAID arrays. The elements you combine to create an Xsan 
volume are described under ‘"How Xsan Storage Is Organized" 
later in this anicle. 
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Controllers and Clients 

When you add a computer to an Xsan SAN, you specify 
whether it will play the role of client, controUer, or both. 

Controllers 

When you set up an Xsan SAN, you assign at least one 
computer to act as die ctmtroller Tlie controller manages the 
SAN volume metadata, maintains a file system journal, and 
controls concurrent access to files. Metadata includes siu:h 
information as where filirs are actually stored and what portions 
of available storage are allocated to new files* 

For high availability, you can add more than one controller 
to a SAN, as shown in Figure 2. If the primaiy controller fails, 
the standby controller takes over. Controllers can also act as 
clienLs, so you can use a standby controller as a working tlieni 
while die primary mniroller is operational. 

Clients 

The eompiiters that users or applicaiioas use to acccs,s SAN 
volumes are called clients, Clients communicate with controllers 
over the Fthernet network but use Fibre Channei to .send and 
retrieve file data to and from the I^l> systems diat prt)vide 
storage for the v<)lume.s. 

SAN Connections 

Xsan uses independent networks to connect storage 
devices, metadata controllers, and client computers: a Fibre 
Channel network and one or two Ethernet networks. 


User Data Over Fibre Channel 

User data is transferred over high-speed Fibre Channel 
connections. Controllers also use a Fibre Ctiannel connection to 
move metadaLa to and from the volume, 

Metadata Over Ethernet 

To eliminate unnecessary traffic on the Fibre Cliannel 
connections, controllers and clients use an Ethernet network to 
exchange file system metadata. (Wlien a controller reads or 
writes meudata on a volume, it uses Fibre Channel.) The Xsan 
Admin application also uses the Ethernet conneaion to let you 
manage the SAN. 

To prevent Internet or intranet traffic from interfering with 
metadata communiaitions, you can set up separate Etliemet 
networks as shown in the illustration. 

Fibre Channel Multi pathing 

Xsan can take advantage of multiple Fibre Oiannel connecdons 
l)etween clients and storage. Xsan can alternate between 
conneciions for eacfi raid and write, or assign each LUN in a volunic 
to one of ilie connections wlien die volume Ls mounteci. 

How Xsan Storage Is Organized 

Users use an Xsan volume die same way they use a logical 
disk* What they don't see is that the SAN volume aetually 
coasLSts of numerous physical disks combined on several levels 
using IIAID techniques. 
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Tiic following illustration shows an example of 1k)w disk space 
provided by tlie indiv'kJiial drive modules in Xserve RAID systems is 
ccMTibined tnio a volume ilmt usen? see as a laige local disk- 

Shared SAi^ 
volume 
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The ft)llowing paragraphs describe these stfirage elements 
and h(}W you organize them to create shared Xsan viiuines- 
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LUNs (RAID Arrays) 

The smallest storage element you work with in Xsan is a 
logical storage device called a LUN (a SCSI logical unit nymtK.T). 
In most storage area networks a l.UN represents a group of 
drives such as a RAID array or a JBOD (just a bunch of disks) 
device. In Xsan, LUNs are Xserve RAID arrays or slices. 

You can create a LUN when you use RAn> Admin to create 
an Xserve RAID array. The controller hardware and sofr^^are in 
the Xserve RAID system combine individual drive modules into 
an array based on the RAID scheme you chot^sc. Each array 
appears on the netw^ork as a separate LUN. If you slice an array, 
each slice appears as a LUN. 

One of your first tasks when you set up a SAN volume is to 
prepare LUNs* If the two RAID 5 arrays on a new Xsen^e RAID 
are not right for your application, you can use RAID Admin to 
create arrays based on other RAID schemes. 

Figure 3 shows four Xserve RAID systems hosting two 
arrays ejich. Half of the arrays use a RAID 0 scheme (striping 
only) for speed while the others use RAID 5 (distributed parity) 
to ensure against data lass* Xsan sees the arrays as LUNs that can 
Ixf combined to create a volume. 

After your Xserve RAID LUNs are set up, you ialiel and 
initialize* tliem for use with the Xsan lile system resing Xsan Admin. 

Storage Pools 

LUNs are combined to form siorage ptK>is. A storage pool 
in a small volume mighi coasLsi of u single RAID aitay, but 
storage pools in nrany volumes consist of multiple arrays. 

Xsan disirilmies file data in parallel across the LUNs in a 
storage pcxil using a RAID 0 (.striping) sclieme. So, you can 
jmprr)ve a client's access sfjced l>y distributing available storage 
over several LUNs in a storage poo] 

You can set up storage pools tiiai have different 
performance or recoverability charaaeristies and assign folders 
to them using affinities* Users on then select where to store files 
based on their need for speed or safety. More infimiiation atout 
this will be covered in "Ftjlders with Affinities." 

As an example, Figure 3 shows eight LUNs combined into 
two storage pools, one ptx)l consisting t>f RAID 0 (fast but not 
recoverable) arrays and Uic otlier made up of RAID S (not as 
fast, l)ul recovx*ral)le) arrays, X.san stripes data across the four 
LUNs in each storage prxjj. 

You use Xsan Admin to add available LUNs to specific 
siorage fX)ols. 

Volumes 

Storage pcM)ls are combined to create the volumes that users 
sc^". From die user's perspective, the SAN volume Icxiks and 
behaves just like a large local disk, except that: 

* The .size of die volume can grow as you add underlying arrays 

or storage poo^ 

• Other users on the SAN c^an access file on the volume at the 

same time 
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\n tlie example illufitniLcd in Figure 5, two stonige [XxJs are 
combined to create a single shared vt>lume. 

You create vcilumes and mount tliem on client computers 
using the Xsan Admin applinition. 

The follow^ing scTeen image sfiows how LUNs* storage poofs, 
and volumes appear as you oi^anize them in the Xsan Admin 
application, lliis example shows a SAN named '"Editing SAN" with 
a single shared volume named "SanVol,” Storage for the volume Is 
provided by two storage pools, “Meta" and “Data," the first based 
on a single LLIN and the second on two. Each of the LlJNs is a 3- 
disk RAID 5 anuy on an Xscrv'c RAID msing 11^ GB drive modules. 
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Figure 4 


Folders witli Affinities 

To control which storage pool is used to store specific 
hies (for example, to provide different levels ii( service for 
different users or appUcatians), you can associate a folder tm 
an Xsan volume with one of the storage pools that make up 
the volume. 

If, for example, you seC up storage pools with different 
balances of performance and data redundancy, users can choose 
between faster and safer storage by putting files in the 
appropriate folder. 

In Figure 3, a predefined folder has an affinity for the 
faster storage jxhjI that is based on RAID 0 arrays. Any file that 
a user copies into this ft)lder is automatically stored on the 
faster arrays. A second folder is associated with the moa* 
secure RAID 5 storage. 

How Xsan Utilizes Available 
Storage 

X.san stores both user files and hie system data on SAN 
volumes, and stripes data across the LUNs in a volume for 
lx;tter performance. 

Metadata and Journal Data 

Xsan records information about the files in an Xsan 
volume using metadata files and file system journals. File 
system metadata includes infonnation such as which specific 
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parr.s of which disks are used to store a y)anicular file and 
whether the file is being accessed. The journal data includes 
a record of file system irunsactions that can help ensure die 
integrity of files in the event of a failure. 

These files are managed by die Xsan metadata controller, 
but are storecl on SAN volumes, not on the coniroller itself By 
default, metadata and journal data are stored on tlie first storage 
pool you add to a volume. You can use Xsan Admin to choose 
wliere tliese files are .stored when you add storage pix)ls to a 
new volume. 

Striping at a Higher I^vel 

when you write a file to a RAID array using RAID 0 
(striping), the file is broken into segments that are spread 
across the individual disk drives in the array. This improves 
performance by writing pieces of the file in paralle] (instead 
of one piece at a time) to the individual disk in the array. 
Xsan applies this same techni(]ue at a second, higher level in 
the storage hierarchy. Within each storage pool in a volume, 
Xsan stripes file data across the individual LUNs that make 
up the storage pool. Once again, performance is improved 
because data is written in parallel. 

You can tune SAN performance by adjusting the amount of 
data written to each LUN in a storage pixA (the "stripe breadth”) 
to suit a critkul application. 

Security 

As a SAN administrator, you can control access to shaied 
volumes in several ways. 

First, users cannot brow.se or mount SAN volumes. Only 
a SAN administrator can specify which voiuines are mounted 
on whicli client computers. One way you can control access 
to data is to mount a volume only on appropriate client 
computers. 

To prevent usem from modifying data on a volume, you can 
mount the volume witli read-only access. 

You c'an also conirot user access to foiders on a volume by 
.specifying owner, gr(3up, and general actress permissions as you 
wt^uld in die rinder. 

You am also set up zones in the underlying Fibre Channel 
network to segregate users and volumes. 

Expanding Storage 

Then,‘ are two ways you can add free space to an X&in volume: 

* Add Xserve RAID sy.stems (new LUNs) to existing storage pcxjls 

• Add entire new storage pools to volumes 

Both methtxls re(]uire you to unmount and remouni the 
volume on clients. 

You can also add new volume.s to a SAN at any time. 


Xsan Capacities 


■fhe l•bllowin}' table ILsb limits anti capacities for Xsan 
volumes. 


Table 1 


Parameter 

Maximum 

Numlx^r of computers in a SAN 
(controllers and clients) 

64 

Number of storage p(X)ls in a volume 

512 

Numl^er of LUNs in a >srorage ptxjl 

32 

Numl^er of LUNs in a volume 

512 

Numl:>er of files in a volume 

4,294,967.296 

LUN size 

2TB 

Voiutne size 

16 TB 


(Mac OS X vlO.3) 
1024 I'B 

(Mac OS X vlO.4) 

File size 

16 TB 


(Mac OS X vlO.3) 
1024 TB 

(Mac OS X vlO.4) , 

Volume name length 

70 chaniners 

File or folder name lenuth 

251 characLers 

SAN name length 

255 characters 

Stoniee p(xd name lenatli 

255 characters 

LUN name (lal^el or disk name) 

242 characters 


Summary 

i hope this article presented a grxxJ overview of Apple's 
Xsan atid storage area networks. In a future article, 1 will disc:us,s 
how to set up a storage area network using Xs;m. 
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How to Stop 

Racing the Clock. 


□Work Longer? □ Work Harder? 


1^ Energize Your Mac! 


We know your day keeps getting longer and longer. With every release of software, your Mac is 
bogged down even more. With every click, there's a pause. You find yourself working longer, working harder. 
A faster Mac means that you can work ^ster, not harder - be more productive! 


Let the original Mac Performance Shop help. Daystar has been creating Mac speed for over 16 years. 
Whether your bottleneck is storage, connectivity or just raw CPU speed, we deliver the performance you 
need, where you need it. 



CPU Upgrades for Raw Speed. We upgrade any Power Macintosh, 
any iMac Flat Panel, any PowerBook G3 and some PowerBook G4s. 

Fast and Large Storage for Real-Time Video. Our TURBOS4T/4 

solutions can make your drives perform like RAM. Projects open in a 
flash and edit in real-time. 

Extreme Wireless. Wireless is great, unless you're getting slow 
transfers. Even Airport Extreme's are slow when the signal is weak. 
Daystar can boost your signals and energize your wireless network. 

But, if You Really need a G5? Daystar is the only Mac Performance 
Manufacturer that is also an Apple Authorized Reseller. Not only can 
you trade-in your system for the latest and greatest... but the Daystar 
Pro's can upgrade it for maximum performance! 

Call 877-439^8646 and beat the clock. 

Authorized Reseller 


■ pVb%V' tbchsology 


Daystar Technology - Your Macintosh Performance Shop 

S018 Bristol Industrial Way, #202, Buford, GA 30518 USA 
Toll Free: 877-439-8646 or 770-614-5400 


Daystar-Tech.com 


Daystar-Forum.com 


Daystar-Store.com 
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